> ## Documentation Index
> Fetch the complete documentation index at: https://docs.token.poryf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> 把 Claude Code 接入再来点Token，用 DeepSeek、GLM、Kimi 模型写代码。

[Claude Code](https://docs.anthropic.com/zh-CN/docs/claude-code/overview) 是 Anthropic 推出的命令行 AI 编程助手，能读写项目文件、执行命令。它通过 Anthropic 格式的接口调用模型，本站把这个接口转换到 DeepSeek、GLM、Kimi 系列，改一个配置文件就能用。

| 模型系列 | 对话 | 流式输出 | 工具调用（读写文件、执行命令） |
| - | - | - | - |
| DeepSeek | 支持 | 支持 | 支持 |
| GLM | 支持 | 支持 | 支持 |
| Kimi | 支持 | 支持 | 支持 |

以上为 2026-09-28 使用 Claude Code 2.1 实测结果。

## 给 AI 助手的一段话

已经有别的 AI 助手（例如 WorkBuddy、Codex）？把下面这段话发给它，它会帮你完成配置。这段话会包含你的完整密钥，接收它的 AI 服务会看到，请只发给你信任的 AI 助手。把 `YOUR_API_KEY` 换成你的密钥，`deepseek-v4-pro` 换成你要用的模型 ID。

<Tip>在控制台 [API 密钥](https://token.poryf.com/keys) 页面点密钥右侧的 **接入配置**，选 Claude Code 后点 **复制给 Agent**，复制到的内容已经填好了你的密钥。</Tip>

````text wrap theme={null}
请帮我把 Claude Code 接入再来点Token（OpenAI 兼容的 API 服务）。

1. 打开配置文件 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json），不存在就新建，所在目录不存在也一并创建。
2. 写入下面的内容。如果文件已存在，只把 env 里的这些键合并进去，保留文件里的其他设置。

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token.poryf.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro"
  }
}
```

3. 保存后运行 `claude -p "Reply with OK"` 验证，告诉我结果。

这段话里有我的 API 密钥：只把它写进本地配置文件，回复时不要完整复述，也不要提交到代码仓库。
````

## 准备

* 在 [API 密钥](https://token.poryf.com/keys) 页面创建一个密钥，并确认 [钱包](https://token.poryf.com/wallet) 有余额。
* 在 [模型广场](https://token.poryf.com/pricing) 选好模型，复制模型 ID，例如 `deepseek-v4-pro`。

## 第 1 步：安装 Claude Code

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```
  </Tab>

  <Tab title="Windows">
    在 PowerShell 中运行：

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```
  </Tab>

  <Tab title="npm">
    已经装了 Node.js 18 或更高版本，也可以用 npm 安装：

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```
  </Tab>
</Tabs>

安装后运行 `claude --version`，能看到版本号就说明装好了。

## 第 2 步：写入配置

<Tabs>
  <Tab title="配置文件（推荐）">
    配置写在 `settings.json` 里，对所有终端长期有效。

    **1. 打开配置文件**，不存在时会自动新建：

    <Tabs>
      <Tab title="macOS">
        ```bash theme={null}
        mkdir -p ~/.claude && touch ~/.claude/settings.json && open -e ~/.claude/settings.json
        ```
      </Tab>

      <Tab title="Linux">
        ```bash theme={null}
        mkdir -p ~/.claude && nano ~/.claude/settings.json
        ```
      </Tab>

      <Tab title="Windows">
        ```powershell theme={null}
        New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null; notepad "$env:USERPROFILE\.claude\settings.json"
        ```
      </Tab>
    </Tabs>

    **2. 粘贴下面的内容并保存**，把 `YOUR_API_KEY` 换成你的密钥，`deepseek-v4-pro` 换成你的模型 ID：

    ```json theme={null}
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://token.poryf.com",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_MODEL": "deepseek-v4-pro",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro"
      }
    }
    ```

    <Note>文件里已经有其他设置时，只把 `env` 里的这几项合并进去，不要覆盖整个文件。</Note>
  </Tab>

  <Tab title="临时环境变量">
    只在当前终端窗口生效，关掉终端就失效，适合先试一试。

    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={null}
        export ANTHROPIC_BASE_URL="https://token.poryf.com"
        export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
        export ANTHROPIC_MODEL="deepseek-v4-pro"
        export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-pro"
        claude
        ```
      </Tab>

      <Tab title="Windows PowerShell">
        ```powershell theme={null}
        $env:ANTHROPIC_BASE_URL = "https://token.poryf.com"
        $env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
        $env:ANTHROPIC_MODEL = "deepseek-v4-pro"
        $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-pro"
        claude
        ```
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="CC Switch">
    用 CC Switch 管理多个服务商时，可以从控制台一键导入，不用手动改文件。步骤见 [CC Switch 一键导入](/integrations/cc-switch)。
  </Tab>
</Tabs>

### 各配置项的作用

| 配置项 | 说明 |
| - | - |
| `ANTHROPIC_BASE_URL` | 填根地址 `https://token.poryf.com`，**不要带 `/v1`**，Claude Code 会自己补上 `/v1/messages` |
| `ANTHROPIC_AUTH_TOKEN` | 本站 API 密钥 |
| `ANTHROPIC_MODEL` | 主模型 |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` / `SONNET` / `HAIKU` | Claude Code 切换档位、执行后台小任务时用的模型。不填时会请求 Claude 官方模型名，本站没有这些模型，调用会失败 |

<Tip>后台小任务（生成标题、总结对话）调用频繁，可以把 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 设成更便宜的型号，例如 `deepseek-flash`。</Tip>

## 第 3 步：验证

**重新打开一个终端**，进入你的项目目录，运行：

```bash theme={null}
claude -p "Reply with OK"
```

看到模型回答 `OK` 就说明接入成功。之后直接运行 `claude` 进入交互模式，让它读一个文件或执行一条命令，确认工具调用也正常。每次调用的用量和费用都可以在 [使用日志](https://token.poryf.com/usage-logs/common) 里查到。

## 常见问题

<AccordionGroup>
  <Accordion title="提示模型不存在（model_not_found）">
    检查 `ANTHROPIC_MODEL` 和三个 `DEFAULT_*_MODEL` 是否**都**填了本站的模型 ID，漏填任何一个，Claude Code 在对应场景下都会请求官方模型名。模型 ID 末尾多了空格也会报这个错。
  </Accordion>

  <Accordion title="报 404 或提示地址错误">
    `ANTHROPIC_BASE_URL` 只填 `https://token.poryf.com`，不要带 `/v1`，也不要填成完整的 `/v1/messages` 地址。
  </Accordion>

  <Accordion title="启动后仍然要求登录 Anthropic 账号">
    配置没有生效。确认配置写在 `settings.json` 的 `env` 字段里、JSON 格式正确，然后重新打开终端再运行 `claude`。

    用下面的命令在本机检查 JSON 格式，只检查格式，不会显示或上传密钥：macOS / Linux 运行 `python3 -m json.tool ~/.claude/settings.json > /dev/null && echo OK`，Windows PowerShell 运行 `Get-Content "$env:USERPROFILE\.claude\settings.json" -Raw | ConvertFrom-Json | Out-Null`，没有报错就说明格式正确。
  </Accordion>

  <Accordion title="提示余额不足或密钥无效（401 / 403）">
    密钥填错、被禁用、过期或额度用完，都会返回 `Invalid token`。到控制台检查密钥状态和钱包余额，详见 [错误排查](/errors)。
  </Accordion>

  <Accordion title="Claude Code 会把我的代码上传到哪里？">
    Claude Code 只会把你在对话中让它读取的内容，随请求发给你配置的接口，也就是本站，再由本站转发给你选的模型。它不会自动上传整个项目。
  </Accordion>
</AccordionGroup>