Skip to content

快速开始

本页给你一条最短路径:只要你能正常进入 claude 对话界面并得到回复,就算接入完成。更细的解释与排障见后续页面。

【推荐配置方式】

如果你想用 CC-Switch 一键完成本页的“写入 settings.json/config.json”等步骤,直接看:CC-Switch 一键配置

0. 先拿到 API Key

  1. 打开 https://ccodezh.com 注册并登录。 1

  2. 进入控制台创建 API Key(一般以 sk- 开头)。 2

  3. 如需计费服务,按控制台指引完成充值。 3

1. 安装 Claude Code

ccodezh 的官方教程要求 Node.js 18+。

安装 CLI:

bash
npm install -g @anthropic-ai/claude-code@latest
claude --version

如果 claude --version 能输出版本号,说明安装成功。

2. 生成配置目录

首次运行一次 Claude Code(用于自动生成配置目录):

bash
claude

首次启动可能会让你选择主题、确认安全提示、信任工作目录等,按提示回车即可。 然后退出(后面再回来继续用)。

3. 写入 settings.json(关键)

Claude Code 的配置目录:

  • Windows:%USERPROFILE%\.claude
  • macOS / Linux:~/.claude

创建或编辑 ~/.claude/settings.json,写入以下内容(把 sk-... 替换为你的真实密钥):

json
{
  "apiKeyHelper": "echo 'sk-替换为你的 API Key'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的 API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

apiKeyHelper不是必须的

可以删除也可以添加。如果出现下面错误则添加或删除后重启再重试。

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

4. 写入 config.json(用于主配置)

~/.claude/config.json 中写入(若文件已存在,请先确认内容再改):

json
{
  "primaryApiKey": "any"
}

5. 启动测试

进入你的项目目录后运行:

bash
claude

能正常对话即表示接入成功。

如果仍无法连接,请直接跳到:问题解决(排障)