跳转到内容
2api2api 文档
打开控制台

Claude

Claude Code

装好 Claude Code，把 2api 的地址和 Key 写进 settings.json，不用登录 Anthropic 账号。

开始前先在控制台创建一个 「CC-Max」分组的 Key。Claude Code 不能用 GPT 分组的 Key。

安装

Section titled “安装”

用官方安装方式，按你的系统选一个：

终端窗口
curl -fsSL https://claude.ai/install.sh | bash

装好后重新打开终端，运行 claude --version 能看到版本号就行。

配置

Section titled “配置”

  1. 打开 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json），没有就新建，写入：

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://2api.dev",
        "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
      }
    }
    • 地址是根地址，不要加 /v1，Claude Code 会自己拼上 /v1/messages。
    • 文件里原来有别的设置，就把这几行合并进 env，不要整个覆盖。
    • JSON 里不能写注释，最后一项后面不能有逗号。

  2. 先配置、后启动：第一步写好再第一次运行 claude，一般不会出现登录界面。如果还是卡在登录或选择登录方式的界面，打开 ~/.claude.json（注意不是 settings.json），在最外层加上 "hasCompletedOnboarding": true，保存后重新启动。这一项不是官方文档里的设置，但 CC Switch 等工具都这样跳过首次引导；以后想恢复官方登录，删掉这一行即可。

  3. 进入项目目录启动：

    终端窗口
    cd 你的项目
    claude

    在 Claude Code 里输入 /status，能看到 Anthropic base URL 是 https://2api.dev，就说明配置生效了。用 /model 可以切换模型。

只想临时试一下

Section titled “只想临时试一下”

不改文件，直接在当前终端设置环境变量，关掉窗口就失效。

终端窗口
export ANTHROPIC_BASE_URL="https://2api.dev"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

后台任务报模型不存在

Section titled “后台任务报模型不存在”

Claude Code 会用一个较小的模型做后台任务。如果报错里出现某个你没用过的模型名（比如 haiku），把后台模型也指定成你分组里有的模型：

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://2api.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "分组里有的模型名",
    "CLAUDE_CODE_SUBAGENT_MODEL": "分组里有的模型名"
  }
}

模型名用 /v1/models 查。

下一步

Section titled “下一步”