QoderWake需配置SSH密钥以安全访问私有代码仓库，推荐使用ED25519密钥对；也可复用RSA密钥、通过~/.ssh/config显式声明主机映射，或转换云平台.pem密钥为OpenSSH格式并配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 QoderWake 能够安全、自动地访问您的私有代码仓库（如 Gitee、GitHub、GitLab 或自建 Git 服务），则必须为其配置有效的 SSH 密钥。QoderWake 本身不生成或托管密钥，它依赖系统级 SSH 配置与标准 OpenSSH 密钥文件路径。以下是完成该配置的多种可行方法：
一、使用系统终端生成 ED25519 密钥对并部署
此方法适用于所有主流操作系统（Windows/Git Bash、macOS、Linux），生成现代、高安全性密钥，且被 QoderWake 官方推荐支持。密钥默认存于标准位置，QoderWake 可自动识别。
1、打开终端（Windows 用户请使用 Git Bash；macOS/Linux 使用原生 Terminal）。
2、执行命令生成密钥对：ssh-keygen -t ed25519 -C "your_email@example.com"。
3、连续按三次回车键，接受默认保存路径 ~/.ssh/id_ed25519 和空密码短语（若需更高安全性，可设置密码短语，后续需配合 ssh-agent）。
4、确认密钥生成成功：ls -l ~/.ssh/id_ed25519* 应显示私钥与公钥文件。
5、将公钥内容复制到剪贴板：cat ~/.ssh/id_ed25519.pub | clip（Windows）或 cat ~/.ssh/id_ed25519.pub | pbcopy（macOS）或 cat ~/.ssh/id_ed25519.pub | xclip -sel clip（Linux，需安装 xclip）。
6、登录目标 Git 平台（如 Gitee 或 GitHub），进入账户「SSH 公钥」设置页，粘贴公钥内容并保存。
7、验证连接：ssh -T git@gitee.com 或 ssh -T git@github.com，输出包含 Hi USERNAME! 即表示成功。
二、复用已存在的 RSA 密钥并校验权限
若您已有可用的 RSA 密钥（例如 id_rsa），QoderWake 可直接复用，但必须确保密钥格式合规、路径标准、权限严格。OpenSSH 默认拒绝读取权限过宽的私钥文件，这是最常见的连接失败原因。
1、检查现有密钥：ls -l ~/.ssh/id_rsa*，确认存在 id_rsa（私钥）和 id_rsa.pub（公钥）。
2、强制修正私钥权限为仅用户可读写：chmod 600 ~/.ssh/id_rsa。
3、确保 ~/.ssh 目录权限为 700：chmod 700 ~/.ssh。
4、确认公钥已添加至目标 Git 平台账户，且未被重复添加或失效。
5、测试是否能通过该密钥连接：ssh -i ~/.ssh/id_rsa -T git@gitee.com（显式指定密钥路径）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
6、若测试成功，QoderWake 在运行 Git 操作时将自动选用该密钥，无需额外配置。
三、通过 ~/.ssh/config 显式声明密钥与主机映射
当您管理多个 Git 仓库（如同时接入 Gitee、GitHub 和内网 GitLab），或使用非标准端口、别名主机、跳转代理时，此方法提供最稳定、可复用的连接控制能力。QoderWake 完全遵循 OpenSSH 的 config 文件规则。
1、编辑或创建配置文件：nano ~/.ssh/config（或使用其他文本编辑器）。
2、添加如下段落（以 Gitee 为例）：
Host gitee.com
HostName gitee.com
User git
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
3、若需为 GitHub 单独配置，新增一个 Host 块，如 Host github.com，并指定对应 IdentityFile。
4、保存文件后，执行 ssh -F ~/.ssh/config -T git@gitee.com 验证 config 是否生效。
5、QoderWake 执行 git clone git@gitee.com:user/repo.git 时，将自动匹配该 Host 规则并加载指定密钥。
四、在腾讯云等云平台生成密钥对并手动导入本地
部分企业环境受限于安全策略，禁止在开发机生成密钥，要求统一由云平台生成并分发。此时需将云平台导出的私钥文件（如 .pem 格式）转换为 OpenSSH 兼容格式，并置于标准路径。
1、从腾讯云控制台下载生成的密钥对（.pem 文件），保存至本地安全位置。
2、使用 openssl 将其转换为 OpenSSH 私钥格式：openssl rsa -in mykey.pem -out ~/.ssh/id_rsa_tencent。
3、设置严格权限：chmod 600 ~/.ssh/id_rsa_tencent。
4、提取对应公钥：ssh-keygen -f ~/.ssh/id_rsa_tencent -y > ~/.ssh/id_rsa_tencent.pub。
5、将 id_rsa_tencent.pub 内容添加至目标 Git 平台账户。
6、在 ~/.ssh/config 中为该密钥创建专属 Host 条目，确保 QoderWake 调用时精准绑定。
