GitCode克隆输入账号密码后报错

使用各种ide工具克隆GitCode代码的时候，例如这里使用Trae，会提示需要输入账号密码，但正确输入后，会提示错误。

这个报错核心是 GitCode 已经停用了 “账号密码” 的 HTTP 认证方式，要求改用个人访问令牌（Personal Access Token，简称 PAT）来替代密码进行身份验证。

remote: <CH.00905401> HTTP Basic: Access denied. remote: The password-based authentication of Git has been removed. Please use your personal access token instead of the password. Request-id is XXXXXX.

第一步：理解报错含义

• HTTP Basic: Access denied：HTTP 基础认证失败，本质是你用账号密码登录被拒绝；
• password-based authentication of Git has been removed：GitCode 已移除密码认证，必须用个人访问令牌（PAT）代替密码；
• 这个改动是 GitCode / 码云等平台的通用安全策略，目的是避免直接暴露账号密码，令牌也可以精细化控制权限。

第二步：生成 GitCode 个人访问令牌（PAT）

这是解决问题的核心步骤，操作在 GitCode 网页端完成：

1. 登录 GitCode 账号，点击右上角的头像 → 选择「设置」；
2. 在左侧菜单栏找到「访问令牌」（或「Personal Access Tokens」）；
3. 点击「生成新令牌」，填写关键信息：
   • 令牌名称：自定义（比如Trae-Project-Access），方便识别用途；
   • 有效期：根据需求选择（比如「永久」或「30 天」，建议选合适的时长）；
   • 权限：至少勾选「仓库」相关的权限（repo），包括「读仓库」「写仓库」等，确保能克隆 / 推送代码；
4. 点击「生成令牌」，务必复制生成的令牌字符串（只会显示一次，刷新页面后就看不到了！），保存到临时文本文件里备用。

第三步：在 Trae 中使用令牌进行认证

生成令牌后，在 Trae 克隆 / 拉取代码时，用「令牌」替代「密码」即可，分两种场景处理：

场景 1：首次在 Trae 中克隆项目（HTTPS 方式）

1. 按之前的步骤，在 Trae 中粘贴 GitCode 的 HTTPS 克隆 URL（比如https://gitcode.net/你的用户名/项目名.git）；
2. 点击「克隆」后，Trae 会弹出认证窗口，要求输入「用户名」和「密码」：
   • 用户名：你的 GitCode 账号（手机号 / 邮箱 / 用户名）；
   • 密码：粘贴你刚生成的个人访问令牌（PAT），而非原账号密码；
3. 确认后，Trae 就能正常克隆指定分支的代码了。

场景 2：如果之前克隆时已经触发过认证失败

先清除 Trae / 系统的 Git 缓存凭证，再重新认证：

1. 打开 Trae 内置终端（或系统命令行），执行以下命令清除缓存：

2. # Windows 系统 git config --global --unset credential.helper # Mac/Linux 系统 git config --global credential.helper osxkeychain # 先重置凭证助手

3. 重新在 Trae 中执行克隆操作，按场景 1 的方式输入「用户名 + 令牌」即可。

补充：推荐改用 SSH 方式（一劳永逸）

如果不想每次都输入令牌，建议配置 SSH 密钥，后续克隆 / 推送代码无需反复认证：

1. 在本地生成 SSH 密钥（Windows/Mac/Linux 通用）：

2. # 打开命令行，执行以下命令，一路回车默认即可 ssh-keygen -t ed25519 -C "你的GitCode邮箱"

3. 复制生成的公钥（Windows 路径：C:\Users\你的用户名\.ssh\id_ed25519.pub；Mac/Linux 路径：~/.ssh/id_ed25519.pub）；
4. 回到 GitCode「设置」→「SSH 密钥」→「添加密钥」，粘贴公钥内容，保存；
5. 之后在 Trae 中使用 SSH 克隆 URL（比如git@gitcode.net:你的用户名/项目名.git），无需输入账号 / 令牌即可直接克隆。