> ## Documentation Index
> Fetch the complete documentation index at: https://doc.onetoken.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> 在 Onetoken 中使用 Claude Code

## 快速开始

本指南将帮助您在几分钟内使用由 Onetoken 提供的 Claude Code.

### 1. 安装 Claude Code

#### 本地安装

<CodeGroup>
  ```shellscript macOS theme={null} theme={null}
  curl -fsSL https://claude.ai/install.sh | bash
  ```

  ```shellscript Windows theme={null} theme={null}
  irm https://claude.ai/install.ps1 | iex
  ```
</CodeGroup>

#### 使用 npm 安装

需要 [Node.js 18 或更高版本](https://nodejs.org/en/download/)

```shellscript theme={null} theme={null}
npm install -g @anthropic-ai/claude-code
```

### 2. 配置 Onetoken API

要通过兼容 Anthropic API 的方式来接入 Onetoken 的模型服务，需要配置以下环境变量。

1. 将`BASE_URL` 设置为`https://onetoken.one`
2. `AUTH_TOKEN` 设置为从 [Onetoken 平台](https://onetoken.one/console/token) 获取的 API Key
3. `MODEL`：设置为[模型列表](https://onetoken.one/pricing)中支持的模型。

<Tabs>
  <Tab title="macOS">
    1) 在终端中执行以下命令，查看默认 Shell 类型。

    ```shellscript theme={null} theme={null}
    echo $SHELL
    ```

    2. 根据 Shell 类型设置环境变量，命令如下：

    <CodeGroup>
      ```shellscript Zsh theme={null} theme={null}
      # ONETOKEN_API_KEY 替换为你从 ONETOKEN 平台获取的 Key
      echo 'export BASE_URL="https://onetoken.one"' >> ~/.zshrc
      echo 'export AUTH_TOKEN="ONETOKEN_API_KEY"' >> ~/.zshrc
      echo 'export MODEL="claude-sonnet-4-5"' >> ~/.zshrc
      ```

      ```shellscript Bash theme={null} theme={null}
      # ONETOKEN_API_KEY 替换为你从 ONETOKEN 平台获取的 Key
      echo 'export BASE_URL="https://onetoken.one"' >> ~/.bash_profile
      echo 'export AUTH_TOKEN="ONETOKEN_API_KEY"' >> ~/.bash_profile
      echo 'export MODEL="claude-sonnet-4-5"' >> ~/.bash_profile
      ```
    </CodeGroup>

    3. 在终端中执行下列命令，使环境变量生效。

    <CodeGroup>
      ```shellscript Zsh theme={null} theme={null}
      source ~/.zshrc
      ```

      ```shellscript Bash theme={null} theme={null}
      source ~/.bash_profile
      ```
    </CodeGroup>

    4. 打开一个新的终端，执行下列命令，查看环境变量是否生效。

    ```shellscript theme={null} theme={null}
    echo $BASE_URL
    echo $AUTH_TOKEN
    echo $MODEL
    ```
  </Tab>

  <Tab title="Windows">
    在 Windows 中，可以通过 CMD 或 PowerShell 将 Onetoken 的 Base URL 和 [API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 设置为环境变量。

    <Tabs>
      <Tab title="CMD">
        1. 在 CMD 中运行以下命令，设置环境变量。

        ```shellscript theme={null} theme={null}
        REM Onetoken API Key 替换 ONETOKEN_API_KEY
        setx AUTH_TOKEN "ONETOKEN_API_KEY"
        setx BASE_URL "https://onetoken.one"
        setx MODEL "claude-sonnet-4-5"
        ```

        2. 打开一个新的 CMD 窗口，运行以下命令，检查环境变量是否生效。

        ```shellscript theme={null} theme={null}
        echo %AUTH_TOKEN%
        echo %BASE_URL%
        echo %MODEL%
        ```
      </Tab>

      <Tab title="PowerShell">
        1. 在 PowerShell 中运行以下命令，设置环境变量。

        ```shellscript theme={null} theme={null}
        # Onetoken API Key 替换 ONETOKEN_API_KEY
        [Environment]::SetEnvironmentVariable("AUTH_TOKEN", "ONETOKEN_API_KEY", [EnvironmentVariableTarget]::User)
        [Environment]::SetEnvironmentVariable("BASE_URL", "https://onetoken.one", [EnvironmentVariableTarget]::User)
        [Environment]::SetEnvironmentVariable("MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)
        ```

        2. 打开一个新的 PowerShell 窗口，运行以下命令，检查环境变量是否生效。

        ```shellscript theme={null} theme={null}
        echo $env:AUTH_TOKEN
        echo $env:BASE_URL
        echo $env:MODEL
        ```
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

### 3. 开始使用

完成配置后，进入你的工作目录，在终端运行 `claude` 命令开始使用 Claude Code。

```bash theme={null} theme={null}
$ cd /path/your-project
> claude
```

初次使用 Claude Code 时，可能会强制要求登录 Anthropic 账户。请按以下步骤操作以跳过该流程：

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/ClaudeCode-doc/1.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=8caea867b6cd8d0760303860734d56d6" alt="Cc 7" width="1622" height="438" data-path="public/cn/cc-7.jpg" data-path="images/ClaudeCode-doc/1.webp" />

1. 定位用户主目录下的 `.claude.json` 文件，具体路径如下：
   * macOS / Linux: `~/.claude.json`
   * Windows: `C:\Users\%USERNAME%\.claude.json`
2. 设置`hasCompletedOnboarding` 字段的值为 `true`

```json theme={null} theme={null}
{
  "hasCompletedOnboarding": true
}
```

3. 保存文件，然后在终端中重新运行 `claude` 。

#### （可选）更多配置模型的方式

Claude Code 支持以下模型配置方式，**按优先级从高到低排列**，优先级高的配置会覆盖优先级低的配置。

1. **对话期间：** 执行`/model <模型名称>`命令切换模型。适用于临时切换模型。

```text theme={null} theme={null}
/model claude-sonnet-4-5
```

2. **启动 Claude Code 时：** 执行`claude --model <模型名称>`指定模型。适用于单次会话。

```text theme={null} theme={null}
claude --model claude-sonnet-4-5
```

3. **设置环境变量**：可按任务复杂度配置不同级别的模型，Claude Code 会根据任务类型自动选择合适的模型。适用于全局生效。

```shellscript theme={null} theme={null}
export DEFAULT_OPUS_MODEL="claude-opus-4-5"
export DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
```

其中：

* `DEFAULT_OPUS_MODEL`：用于复杂推理、架构设计等高难度任务。
* `DEFAULT_SONNET_MODEL`：用于代码编写、功能实现等日常任务。
* `DEFAULT_HAIKU_MODEL`：用于语法检查、文件搜索等简单任务。

4. **在 setting.json 配置文件中永久设置**：在项目根目录或用户主目录创建`settings.json`文件，并写入模型配置信息，可分别进行项目级或用户级的永久配置。

```json theme={null} theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "api key",
    "ANTHROPIC_BASE_URL": "https://onetoken.one",
    "DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}
```

## 通过 cc-switch 配置

1. 运行 CC-Switch，点击「添加供应商」。

<img src="https://mintcdn.com/onetoken-9a3c590a/KFIRj5hibFTyL0AW/images/claudecode/1.png?fit=max&auto=format&n=KFIRj5hibFTyL0AW&q=85&s=295800a351629928c4c600fd5cc40552" width="2000" height="1302" data-path="images/claudecode/1.png" />

2. 在预设列表中选择「自定义配置」。

<img src="https://mintcdn.com/onetoken-9a3c590a/KFIRj5hibFTyL0AW/images/claudecode/2.png?fit=max&auto=format&n=KFIRj5hibFTyL0AW&q=85&s=ec9804cbebac9663f314f34294bb7cd2" width="2000" height="1302" data-path="images/claudecode/2.png" />

3. 在「API Key」栏中填写你的密钥和请求地址

<img src="https://mintcdn.com/onetoken-9a3c590a/KFIRj5hibFTyL0AW/images/claudecode/3.png?fit=max&auto=format&n=KFIRj5hibFTyL0AW&q=85&s=9f492b22bc49059dcb988b26103ae2e5" width="2022" height="1336" data-path="images/claudecode/3.png" />

4. 配置完成后，点击「添加」保存设置。

<img src="https://mintcdn.com/onetoken-9a3c590a/KFIRj5hibFTyL0AW/images/claudecode/4.png?fit=max&auto=format&n=KFIRj5hibFTyL0AW&q=85&s=a534955d70b61579bd71df73edf88a77" width="2022" height="1336" data-path="images/claudecode/4.png" />

5. 返回首页，在供应商列表中选择「onetoken」，点击「启动」即可使用。

<img src="https://mintcdn.com/onetoken-9a3c590a/KFIRj5hibFTyL0AW/images/claudecode/5.png?fit=max&auto=format&n=KFIRj5hibFTyL0AW&q=85&s=d380d7b68f9655bf58a0c7959dde12f9" width="2022" height="1336" data-path="images/claudecode/5.png" />

## 通过 VS Code 插件配置

1. 运行 VS Code，安装插件。

<Frame>
  <img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/ClaudeCode-doc/2.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=fe1d7be31bf9a402f8c99e4a8c99fd0c" alt="I Shot 2026 03 25 11 44 03" width="1958" height="724" data-path="images/iShot_2026-03-25_11.44.03.jpg" data-path="images/ClaudeCode-doc/2.webp" />
</Frame>

2. 按下 `Ctrl + Shift + P` (或 `Cmd + Shift + P`)，输入 `Settings` 打开设置。

<Frame>
  <img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/ClaudeCode-doc/3.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=0fc717f943e393b11d51675c369f12f2" alt="I Shot 2026 03 25 11 47 48" width="1772" height="976" data-path="images/iShot_2026-03-25_11.47.48.jpg" data-path="images/ClaudeCode-doc/3.webp" />
</Frame>

3. 搜索 `Claude Code` ，找到 `Claude Code: Environment Variable` → `Edit in settings.json` 。

<Frame>
  <img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/ClaudeCode-doc/4.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=d339edb2b8be2377b30881d3ca79cd23" alt="I Shot 2026 03 25 11 49 37" width="1940" height="1248" data-path="images/iShot_2026-03-25_11.49.37.jpg" data-path="images/ClaudeCode-doc/4.webp" />
</Frame>

4. 在 `claudeCode.environmentVariables` 中填入 Onetoken 相关信息。

<Frame>
  <img src="https://mintcdn.com/onetoken-9a3c590a/KFIRj5hibFTyL0AW/images/claudecode/6.png?fit=max&auto=format&n=KFIRj5hibFTyL0AW&q=85&s=6624882ef17dbce5afe057b4e35c2ab4" alt="I Shot 2026 03 25 11 53 07" width="1156" height="304" data-path="images/iShot_2026-03-25_11.53.07.jpg" data-path="images/claudecode/6.png" />
</Frame>

## 在 claude code 中使用 deepseek 模型

可用模型 `deepseek-r1-distill-qwen-14b` `deepseek-v3` `deepseek-v3-0324` `deepseek-v3-1-250821` `deepseek-v3.2` `deepseek-v4-flash` `deepseek-v4-pro`

方式一: 直接修配置文件

定位用户主目录下的 `.claude.json` 文件，具体路径如下：

* macOS / Linux: `~/.claude.json`
* Windows: `C:\Users\%USERNAME%\.claude.json`

把 `ANTHROPIC_MODEL` 的值修改成 deepseek 的模型名

```json theme={null} theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-**",
    "ANTHROPIC_BASE_URL": "https://onetoken.one",
    "ANTHROPIC_MODEL": "deepseek-v4-pro"
  },
  "includeCoAuthoredBy": false
}
```

方式二：直接使用 CC Switch 修改配置文件，模型名改为 deepseek 的模型名，重启 claude code 即可。

## 常见问题

### Q：在 Claude Code 中使用，提示「401 , No token provided....」

打开 Claude 终端，输入 `/config` ，找到 `Use custom API key` 选项，检查 Token 是否正确配置。

<img src="https://mintcdn.com/onetoken-9a3c590a/Y02IerIYTPVRQQ-L/images/ClaudeCode-doc/5.webp?fit=max&auto=format&n=Y02IerIYTPVRQQ-L&q=85&s=fd23d3b7d8a64146773599a485c91751" alt="install" width="1220" height="760" data-path="public/cn/cc-6.png" data-path="images/ClaudeCode-doc/5.webp" />

### Q：macOS 中安装成功后仍然报错：`zsh: command not found: claude`

这是因为 Claude CLI 已安装，但其可执行目录未加入系统 `PATH`。

1. 确认 Claude 安装路径。Claude Code 官方脚本通常安装在以下目录之一：

* `~/.claude/bin`
* `~/.local/bin`

在终端执行：

```shellscript theme={null} theme={null}
ls -l ~/.claude/bin
或
ls -l ~/.local/bin | grep claude
```

如果看到 claude 文件，说明安装成功，只是 PATH 未配置。

2. 将安装目录加入 PATH。根据实际安装位置执行对应命令：

##### 情况 A：安装在 `~/.claude/bin`

```shellscript theme={null} theme={null}
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

##### 情况 B：安装在 `~/.local/bin`

```shellscript theme={null} theme={null}
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

3. 验证是否生效。执行：

```text theme={null} theme={null}
which claude
claude -v
```

若能看到 `claude` 路径及版本号，说明安装成功。

### Q：Claude Code 无法连接 Anthropic 服务

升级到最新版本的 Claude Code 后，若出现无法连接 Anthropic 服务或认证失败的情况，通常是由于认证请求头名称已发生调整所致。新版本要求将请求头由 `API_KEY` 修改为 `AUTH_TOKEN`，API Key 的值无需更换，仅需更新请求头名称并重新加载配置即可。具体操作可参考本文档重新配置。

### Q: Login:API Error: 403

<img src="https://mintcdn.com/onetoken-9a3c590a/gdX-WXR7O4SB8M6G/images/claudecode/7.png?fit=max&auto=format&n=gdX-WXR7O4SB8M6G&q=85&s=e0944190bab372a92e15bd26f9bd92b9" width="1692" height="543" data-path="images/claudecode/7.png" />

cc升级到最新版，并且关闭ccs的本地代理跟故障转移功能

### Q：如何开启 1 小时缓存

1.打开全局配置文件\~/.claude/settings.json(或项目目录下的.claude/settings.json );\\

2.添加 env字段:

```

{ "env": { "ENABLE_PROMPT_CACHING_1H": "1" } }

```

祝你使用愉快！