只需几分钟,即可完成 Claude Code 的安装和配置
选择以下任一方式安装 Claude Code:
需要 Node.js 18+
npm install -g @anthropic-ai/claude-code在 VSCode 扩展商店搜索:
Claude CodeClaude Code 的配置文件位于 ~/.claude/settings.json
# 创建配置文件(如果不存在)
mkdir -p ~/.claude
touch ~/.claude/settings.json新增/编辑 ~/.claude/settings.json 文件
{
"apiKeyHelper": "echo '登录网站后控制台中的 API 密钥'",
"env": {
"ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
"ANTHROPIC_AUTH_TOKEN": "登录网站后控制台中的 API 密钥"
}
}说明:将上述配置中的“登录网站后控制台中的 API 密钥”替换为你在控制台获取的实际密钥
⚠️ 重要提示:
• 使用一键配置脚本时,不会自动添加 "apiKeyHelper" 这一行配置
• 如果使用脚本后进入 claude 出现类似 Failed to connect to api.anthropic.com: ERR_BAD_REQUEST 的报错,说明配置缺少 "apiKeyHelper" 这一行
• 遇到此问题时,请手动打开 ~/.claude/settings.json 文件,添加上述完整配置中的 "apiKeyHelper" 这一行即可
如果您需要使用 n 渠道的模型,需要在 env 中指定模型名称。
💡 说明:
• 使用官方渠道模型(无后缀):无需配置,直接使用即可
• 使用特殊渠道模型(-n 后缀):需要在 env 中指定完整的模型名称
示例配置(使用 n 渠道模型):
{
"apiKeyHelper": "echo '登录网站后控制台中的 API 密钥'",
"env": {
"ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
"ANTHROPIC_AUTH_TOKEN": "登录网站后控制台中的 API 密钥",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001-n",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101-n",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929-n",
"ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929-n"
}
}参数说明:
• ANTHROPIC_DEFAULT_HAIKU_MODEL: 默认使用的 Haiku 模型
• ANTHROPIC_DEFAULT_OPUS_MODEL: 默认使用的 Opus 模型
• ANTHROPIC_DEFAULT_SONNET_MODEL: 默认使用的 Sonnet 模型
• ANTHROPIC_MODEL: 当前使用的模型(通常设置为 Sonnet)
⚠️ 注意:不同渠道的模型定价和质量可能有所不同,请查看 模型定价页面 了解详情。
在 ~/.claude 目录中创建 config.json 文件
# 创建 config.json
touch ~/.claude/config.json编辑 ~/.claude/config.json 文件,添加以下内容:
{
"primaryApiKey": "any"
}如果在使用 Claude Code 插件时遇到对话中途跳转到登录页面的问题,可以添加以下配置解决。
💡 问题症状:
在 Claude Code 对话过程中,突然跳转到需要登录的页面,导致工作中断。
解决方法:在用户目录中创建或编辑 .claude.json 文件
# 创建或编辑 .claude.json
touch ~/.claude.json在文件中添加以下内容:
{
"hasCompletedOnboarding": true
}✅ 说明:添加此配置后,Claude Code 将跳过新手引导流程,避免在使用过程中出现登录跳转问题。重启 Claude Code 后配置即可生效。
重启 Claude Code,配置即可生效。现在你可以开始使用 ccodezh 中转服务了!