使用各种 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 网页端完成：
- 登录 GitCode 账号，点击右上角的头像 → 选择「设置」；
- 在左侧菜单栏找到「访问令牌」（或「Personal Access Tokens」）；
- 点击「生成新令牌」，填写关键信息：
- 令牌名称：自定义（如
Trae-Project-Access），方便识别用途； - 有效期：根据需求选择（如「永久」或「30 天」，建议选合适的时长）；
- 权限：至少勾选「仓库」相关的权限（
repo），包括「读仓库」「写仓库」等，确保能克隆/推送代码；
- 令牌名称：自定义（如
- 点击「生成令牌」，务必复制生成的令牌字符串（只会显示一次，刷新页面后就看不到了！），保存到临时文本文件里备用。
第三步：在 Trae 中使用令牌进行认证
生成令牌后，在 Trae 克隆/拉取代码时，用「令牌」替代「密码」即可，分两种场景处理：
场景 1：首次在 Trae 中克隆项目（HTTPS 方式）
- 按之前的步骤，在 Trae 中粘贴 GitCode 的 HTTPS 克隆 URL（如
https://gitcode.net/你的用户名/项目名.git）； - 点击「克隆」后，Trae 会弹出认证窗口，要求输入「用户名」和「密码」：
- 用户名：你的 GitCode 账号（手机号/邮箱/用户名）；
- 密码：粘贴你刚生成的个人访问令牌（PAT），而非原账号密码；
- 确认后，Trae 就能正常克隆指定分支的代码了。
场景 2：如果之前克隆时已经触发过认证失败
先清除 Trae/系统的 Git 缓存凭证，再重新认证：
- 打开 Trae 内置终端（或系统命令行），执行以下命令清除缓存：
# Windows 系统
git config --global --unset credential.helper
# Mac/Linux 系统
git config --global credential.helper osxkeychain
- 重新在 Trae 中执行克隆操作，按场景 1 的方式输入「用户名 + 令牌」即可。
补充：推荐改用 SSH 方式（一劳永逸）
如果不想每次都输入令牌，建议配置 SSH 密钥，后续克隆/推送代码无需反复认证：
- 在本地生成 SSH 密钥（Windows/Mac/Linux 通用）：
ssh-keygen -t ed25519 -C "你的 GitCode 邮箱"
- 复制生成的公钥（Windows 路径：
C:\Users\你的用户名\.ssh\id_ed25519.pub；Mac/Linux 路径：~/.ssh/id_ed25519.pub）； - 回到 GitCode「设置」→「SSH 密钥」→「添加密钥」，粘贴公钥内容，保存；
- 之后在 Trae 中使用 SSH 克隆 URL（如
[email protected]:你的用户名/项目名.git），无需输入账号/令牌即可直接克隆。
