# Claude Code

:::tip[更省事的办法]
- 用 [magpie](https://docs.2api.dev/magpie/) 一键切换，不用碰配置文件。
- 或者在控制台「API 密钥」列表里点 Key 后面的「使用密钥」，复制控制台生成的 Claude Code 配置。
:::

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

## 安装

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

```bash
  curl -fsSL https://claude.ai/install.sh | bash
  ```
  ```powershell
  irm https://claude.ai/install.ps1 | iex
  ```
  ```batch
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
  ```bash
  brew install --cask claude-code
  winget install Anthropic.ClaudeCode
  npm install -g @anthropic-ai/claude-code
  ```
  npm 方式需要 Node.js 22 以上，不要加 `sudo`。
  装好后**重新打开终端**，运行 `claude --version` 能看到版本号就行。

## 配置

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

   ```json title="~/.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. 进入项目目录启动：

   ```bash
   cd 你的项目
   claude
   ```

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

:::note[记得手动更新]
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 会顺带关掉自动更新。隔一段时间运行一次 `claude update`。版本太旧可能出现缓存命中率低、扣费偏多的问题。
:::

## 只想临时试一下

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

```bash
  export ANTHROPIC_BASE_URL="https://2api.dev"
  export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
  export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
  claude
  ```
  ```powershell
  $env:ANTHROPIC_BASE_URL="https://2api.dev"
  $env:ANTHROPIC_AUTH_TOKEN="sk-你的Key"
  $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
  claude
  ```
  ```batch
  set ANTHROPIC_BASE_URL=https://2api.dev
  set ANTHROPIC_AUTH_TOKEN=sk-你的Key
  set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
  claude
  ```
  CMD 里等号后面**不要加引号**，引号会被当成值的一部分。
  :::caution[只设一个 Key 变量]
`ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_API_KEY` 不要同时设置，否则会提示认证冲突。系统环境变量或 `~/.zshrc` 里如果还有旧的 `ANTHROPIC_API_KEY`，先删掉。
:::

## 后台任务报模型不存在

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

```json title="~/.claude/settings.json" ins={6-7}
{
  "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`](https://docs.2api.dev/start/endpoints/#模型名) 查。

## 下一步

- 在 VS Code 或 Cursor 里用：[Claude Code 插件](https://docs.2api.dev/clients/claude-code-ide/)
- 遇到报错：[Claude Code 常见问题](https://docs.2api.dev/faq/claude-code/)