Git 多账号多项目管理配置（GitHub+GitLab，附 Codex/Claude 提示词）

1. 同一台电脑上GitHub 与 GitLab 多账号为什么总串一台电脑同时挂着公司 GitLab 和个人 GitHub是很多开发者的日常。平时只有一个账号时配置一次user.name、user.emailclone 下来就能正常 pull、push根本不会去想“身份管理”这件事。可一旦两个账号并存问题就会集中爆发提交记录里出现的是个人邮箱代码却推到了公司仓库或者 SSH 认证命中了错误的密钥push 直接被拒。我见过最尴尬的场景是同事把私人项目的 commit 推到了工作 GitLab 的 group 里第二天被 leader 在群里点名。这类问题的根源是很多人没意识到 Git 其实有两套完全独立的“身份”。第一套是远程认证身份决定你有没有权限访问 GitHub 或 GitLab 上的仓库由 SSH Key 和 SSH Host 配置控制。第二套是Commit 作者身份决定这次提交在 Git 历史里记录的名字和邮箱是谁由git config user.name和user.email控制。这两套身份互不干涉可以一个用工作、一个用个人也可以同时用工作——但如果你不显式配置它们就会各自“默认”然后串在一起。本文聚焦的场景很具体同一台机器上工作账户用 GitLab、个人账户用 GitHub需要做到 SSH 密钥分账号生成、~/.ssh/config主机别名绑定、仓库级user.name/user.email隔离、remote 地址正确切换。文末还会给出让 Codex 和 Claude Code 这类 AI 助手帮你管理多账号的提示词模板以及用ssh -T和git remote -v验证账号命中的完整流程。适合谁看手上有两个及以上 Git 账号、经常在工作和个人项目之间切换、被“提交邮箱串了”或“SSH 用错账号”坑过的开发者。跟着做一遍基本能一次性把多账号环境理顺。2. 前置准备TaoToken 与 SSH 密钥分账号生成在正式配置之前先把两件事准备好一是 SSH 密钥二是如果你打算用 AI 助手辅助管理需要一个稳定的模型调用入口。这里我用 TaoToken 作为统一接入层它把 GitHub、GitLab 相关的 AI 辅助场景比如让 Codex 帮你生成 SSH config、让 Claude Code 检查 remote 配置收敛到一个 API 地址上省得每个工具单独配一遍。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是给 Codex、Claude Code 这类工具提供统一的模型调用能力你不需要在每个工具里重复填不同的 key。对于本文的多账号管理场景它主要用在“让 AI 帮你生成配置片段”和“让 AI 帮你排查 remote 串用”这两个环节。接下来生成两把独立的 SSH Key。假设工作账户用 GitLab、邮箱workcompany.com个人账户用 GitHub、邮箱meexample.com。生成工作 GitLab 密钥ssh-keygen -t ed25519 -C workcompany.com \ -f ~/.ssh/id_ed25519_gitlab_work生成个人 GitHub 密钥ssh-keygen -t ed25519 -C meexample.com \ -f ~/.ssh/id_ed25519_github_personal执行后~/.ssh/目录下会多出四个文件~/.ssh/ ├── id_ed25519_gitlab_work ├── id_ed25519_gitlab_work.pub ├── id_ed25519_github_personal └── id_ed25519_github_personal.pub带.pub的是公钥可以上传到平台不带.pub的是私钥只留在本机绝不能泄露。这里有个坑要提醒如果你本机已经有 SSH Key不要直接覆盖。覆盖私钥后原来绑定了对应公钥的平台会立刻无法认证。想给工作、个人分不同密钥就用新文件名生成别动旧文件。生成完把两个公钥分别添加到平台。GitLab 在头像 → Edit profile → SSH Keys → Add new key粘贴id_ed25519_gitlab_work.pub的内容。GitHub 在头像 → Settings → SSH and GPG keys → New SSH key粘贴id_ed25519_github_personal.pub的内容。Title 随便起个能认出来的名字比如“Work Laptop”。这里还有一个高频坑如果你有两个 GitHub 账号不要把同一把 SSH Key 同时绑到两个账号上GitHub 会直接报Key already in use。多账号必须用不同的密钥。如果你想让 AI 帮你生成这两套密钥可以用下面这个提示词模板帮我为工作 GitLab 和个人 GitHub 分别生成 ed25519 SSH key 文件名使用 id_ed25519_gitlab_work 和 id_ed25519_github_personal。 不要覆盖已有密钥完成后告诉我需要上传哪两个公钥文件。把这段丢给 Codex 或 Claude Code它会给出对应的ssh-keygen命令并提醒你上传哪些.pub文件。如果你用的是 TaoToken 接入的模型对话能力可以直接在 https://taotoken.net/api 对应的对话入口里跑这段提示词省去本地反复试错。3. 可复制配置SSH config 与仓库级 git config 片段密钥准备好之后核心工作是把“账号”和“密钥”绑定起来。这一步靠~/.ssh/config的主机别名完成。编辑这个文件Windows 下路径是C:\Users\用户名\.ssh\config加入以下内容Host gitlab-work HostName gitlab.com User git IdentityFile ~/.ssh/id_ed25519_gitlab_work IdentitiesOnly yes Host github-personal HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github_personal IdentitiesOnly yes几个配置项的含义Host是你自己定义的别名后面 remote 地址里就用它HostName是真正要连接的服务器域名IdentityFile指定这个别名固定使用哪把私钥IdentitiesOnly yes是关键它强制 SSH 只使用指定的身份避免 ssh-agent 里存了多把密钥时挨个试、试错甚至串用。如果公司用的是自建 GitLab比如gitlab.company.com把HostName gitlab.com改成公司域名即可别名gitlab-work保持不变。配置完成后remote 地址就不再写gitgithub.com:myname/project.git而是用别名gitgithub-personal:myname/project.git gitgitlab-work:company/project.git这样你一眼看 remote 地址就知道它会走哪个账号、哪把 Key。接下来是仓库级身份配置。进入工作项目目录cd ~/projects/work-project git config --local user.name Your Work Name git config --local user.email workcompany.com git remote set-url origin gitgitlab-work:company/work-project.git如果还没有 origingit init git remote add origin gitgitlab-work:company/work-project.git个人项目同理cd ~/projects/personal-project git config --local user.name Your Personal Name git config --local user.email meexample.com git remote set-url origin gitgithub-personal:myname/personal-project.git这里显式写--local是有意为之。在 Git 仓库里执行git config user.name xxx不带范围参数时默认就是 local效果一样。但在工作、个人混用的机器上显式写--local意图更清楚也更不容易误改全局身份。如果你想让 AI 帮你生成这些配置可以用这个提示词帮我把当前仓库配置为工作 GitLab 项目 仓库级设置工作 user.name/user.email origin 使用 gitlab-work SSH Host。 不要修改全局 Git 配置完成后验证 identity 和 remote。对于“一个项目同时推 GitLab 和 GitHub”的场景推荐给两个远程分别起名字而不是反复改 origingit remote add work gitgitlab-work:company/project.git git remote add personal gitgithub-personal:myname/project.git之后分别推送git push work main git push personal main这种方式的优点是状态清晰某个平台失败可以单独重试不影响另一个 remote。Git 官方文档对“不同位置”的远程也建议使用独立 remote不建议为了少敲一条命令把两个仓库混在同一个 remote 里。如果你确实想一条命令推两个地址可以这样配置git remote add sync gitgitlab-work:company/project.git git remote set-url --add --push sync gitgitlab-work:company/project.git git remote set-url --add --push sync gitgithub-personal:myname/project.git之后git push sync main会依次推送到两个地址。但要注意一个成功、另一个失败时成功的推送不会自动回滚。所以我还是推荐前面的work和personal独立方案。4. 验证请求ssh -T 与 git remote -v 确认账号命中配置写完不代表生效必须验证。验证分三层SSH 认证层、remote 地址层、Commit 身份层。先测 SSH 认证ssh -T gitgitlab-work ssh -T gitgithub-personalGitLab 成功时会返回类似Welcome to GitLab, your-work-name!的欢迎信息。GitHub 成功时会返回Hi myname! Youve successfully authenticated, but GitHub does not provide shell access.如果这里报Permission denied (publickey)说明密钥没绑对回到第 5 节排查。再检查 remotegit remote -v工作项目应该看到origin gitgitlab-work:company/work-project.git (fetch) origin gitgitlab-work:company/work-project.git (push)个人项目应该看到origin gitgithub-personal:myname/personal-project.git (fetch) origin gitgithub-personal:myname/personal-project.git (push)最后检查 Commit 身份用--show-origin能看到配置来自哪个文件git config --show-origin --get user.name git config --show-origin --get user.email工作项目理想输出file:.git/config Your Work Name file:.git/config workcompany.com如果输出里出现file:/home/user/.gitconfig而不是file:.git/config说明这个仓库没有设置 local 身份正在用全局配置这就是串身份的隐患。这里要特别强调一个概念一个项目推两个远程时Commit 身份不会自动切换。假设当前仓库 local 配置的是工作身份你git commit之后作者信息已经写进 Commit 对象。之后无论git push work main还是git push personal main两个平台收到的都是同一个 Commit作者姓名和邮箱不会因为推到不同 remote 而变化。所以记住这条对应关系SSH Key 决定“有没有权限推到这个远程仓库”user.name/user.email决定“这个 Commit 记录的是谁”。两者独立各管各的。如果你想让 AI 帮你做一次完整体检用这个提示词检查当前 Git 仓库的 user.name、user.email、配置来源、remote 和 SSH 认证 判断是否存在工作/个人账号串用只检查并说明问题不要修改配置。把输出贴给 Codex 或 Claude Code它能帮你判断哪一层配错了。如果你通过 TaoToken 接入模型对话可以在 https://taotoken.net/api 对应的入口直接跑不用来回切工具。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth多账号配置踩坑集中在几个固定报错上逐个对照排查。报错一Permission denied (publickey)或 401。这是 SSH 认证失败最常见原因是~/.ssh/config里IdentityFile路径写错或者公钥没上传到对应平台。先确认ls -l ~/.ssh/id_ed25519_gitlab_work文件存在再确认 GitLab 的 SSH Keys 页面里能看到对应指纹。还有一个隐蔽原因IdentitiesOnly yes没写ssh-agent 里存了多把密钥SSH 挨个试的时候命中了错误的那个。加上IdentitiesOnly yes强制指定身份即可。报错二local proxy failed或连接超时。这类报错通常和网络环境有关检查你的网络是否能正常访问目标平台。如果公司网络有出口限制确认 GitLab 自建域名是否在允许列表内。不要尝试用任何非正规的网络中转手段合规环境下应该走公司提供的正规网络通道。报错三reading choices或模型调用返回异常。如果你在用 Codex、Claude Code 这类 AI 助手辅助管理 Git报错里出现reading choices通常是模型接口返回格式异常。检查你的 Base URL 是否指向 https://taotoken.net/api Key 是否有效Model ID 是否填对。这三件套Base URL Key Model ID缺一不可。以 Codex 的auth.json为例配置结构大致如下{ base_url: https://taotoken.net/api, api_key: sk-你的key, model: claude-sonnet-4-20250514 }如果你用的是 Cline 的 MCP 配置或者 CC Switch 这类多配置切换工具同样要保证 Base URL、Key、Model ID 三项完整。任何一项缺失或写错都会导致reading choices之类的解析错误。报错四OAuth 相关报错。如果你之前用 HTTPS OAuth 方式连接过 GitHub切换 SSH 后可能残留旧的凭据缓存导致认证走错路径。检查git remote -v确认地址已经是gitgithub-personal:...而不是https://...。如果还是 HTTPS用git remote set-url origin gitgithub-personal:myname/project.git切过来。同时清理系统凭据管理器里旧的 GitHub 凭据避免它继续干扰。报错五Key already in use。这是 GitHub 特有的报错说明你把同一把公钥绑到了两个 GitHub 账号。多账号必须用不同密钥重新生成一把新密钥绑到第二个账号即可。排查时建议按“SSH 层 → remote 层 → Commit 层”的顺序逐层验证不要跳步。每一层都有对应的验证命令哪一层报错就修哪一层。6. 语义一致 CTA把多账号管理交给 AI 助手配置理顺之后日常维护其实可以交给 AI 助手。比如新 clone 一个项目让 Codex 帮你判断该用哪个身份、哪个 remote或者提交前让 Claude Code 检查一遍当前仓库的 user.email 是不是工作邮箱。这些重复性的检查工作用提示词模板固化下来会省很多事。如果你需要长期在多个项目、多个账号之间切换建议用 Coding Plan 把模型调用能力固定下来避免每次临时找 key。入口在 https://taotoken.net/api 对应的 Coding Plan 页面适合需要稳定编码辅助和 Agent 能力的场景。如果只是偶尔验证一下模型输出、跑跑提示词用模型对话入口就够了地址同样是 https://taotoken.net/api 下的对话功能。需要管理多个 API Key、给不同项目分配不同额度时去 API Keys 页面配置路径在 https://taotoken.net/api 下的 api-keys 管理入口。接入文档里有完整的 Base URL、Key、Model ID 三件套说明第一次配置建议对照文档走一遍https://taotoken.net/api 下的 doc 页面。如果你用的是 Claude Code 的 Anthropic 兼容模式文档里也有对应的配置示例。最后留一个实用习惯每次新建仓库后先跑一遍git config --show-origin --get user.email和git remote -v确认身份和 remote 都对再开始提交。这个动作花不了十秒但能避免绝大多数“提交串账号”的尴尬。多账号管理说到底不是配置多复杂而是把验证变成肌肉记忆。