快速开始

只需几分钟,即可完成 Claude Code 的安装和配置

0

安装 Claude Code

选择以下任一方式安装 Claude Code:

💻

终端命令

需要 Node.js 18+

npm install -g @anthropic-ai/claude-code
🔌

VSCode 插件

在 VSCode 扩展商店搜索:

Claude Code

安装完成后,选择配置方式

推荐使用快速配置,省时省力

🚀

方式一:快速配置(推荐)

使用一键脚本自动完成配置,无需手动编辑文件

前往控制台下载脚本
📝

方式二:手动配置

按照以下步骤手动创建配置文件

1

创建配置文件

Claude Code 的配置文件位于 ~/.claude/settings.json

# 创建配置文件(如果不存在) mkdir -p ~/.claude touch ~/.claude/settings.json
2

添加 API 配置

新增/编辑 ~/.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" 这一行即可

2.5

配置模型渠道(可选)

如果您需要使用 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)

⚠️ 注意:不同渠道的模型定价和质量可能有所不同,请查看 模型定价页面 了解详情。

3

添加主配置文件

在 ~/.claude 目录中创建 config.json 文件

# 创建 config.json touch ~/.claude/config.json

编辑 ~/.claude/config.json 文件,添加以下内容:

{ "primaryApiKey": "any" }
3.5

解决登录跳转问题(可选)

如果在使用 Claude Code 插件时遇到对话中途跳转到登录页面的问题,可以添加以下配置解决。

💡 问题症状:

在 Claude Code 对话过程中,突然跳转到需要登录的页面,导致工作中断。

解决方法:在用户目录中创建或编辑 .claude.json 文件

# 创建或编辑 .claude.json touch ~/.claude.json

在文件中添加以下内容:

{ "hasCompletedOnboarding": true }

✅ 说明:添加此配置后,Claude Code 将跳过新手引导流程,避免在使用过程中出现登录跳转问题。重启 Claude Code 后配置即可生效。

4

完成配置

重启 Claude Code,配置即可生效。现在你可以开始使用 ccodezh 中转服务了!