CC
ccodezh

快速开始

只需几分钟，即可完成 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 中转服务了。