Claude Code

Claude Code、Claude Code Desktop 接入 51token

Claude Code 是运行在终端内的 AI 编程助手。51token 提供 Anthropic 兼容端点,可把任意支持的模型当作 Claude 来用,无需官方订阅。

推荐用 CC-Switch 图形化配置;本文是手动配置方式,适合已熟悉命令行的用户。

1. 环境配置

1.1 临时环境变量

如果你已经安装了 Claude Code,只需修改以下环境变量。API Key 在 51token.one/keys 获取。

Linux / Mac 用户,直接在终端中执行:

text
export ANTHROPIC_BASE_URL=https://51token.one/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 51token API Key>
export ANTHROPIC_MODEL=gpt-5.6-sol
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.6-sol
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.6-sol
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.4-mini
export CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.4-mini
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0

Windows 用户,在 PowerShell 中执行:

text
$env:ANTHROPIC_BASE_URL="https://51token.one/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 51token API Key>"

$env:ANTHROPIC_MODEL="gpt-5.6-sol"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.6-sol"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.6-sol"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5.4-mini"
$env:CLAUDE_CODE_SUBAGENT_MODEL="gpt-5.4-mini"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER="0"
环境变量 说明
ANTHROPIC_BASE_URL 51token 的 Anthropic 兼容端点,固定为 https://51token.one/anthropic
ANTHROPIC_AUTH_TOKEN 你的 51token API Key(在 51token.one/keys 获取)
ANTHROPIC_MODEL 默认模型,填 51token 支持的模型名,如 gpt-5.6-sol
ANTHROPIC_DEFAULT_OPUS_MODEL / SONNET / HAIKU 各档位默认模型,可按需映射
CLAUDE_CODE_SUBAGENT_MODEL 子代理使用的轻量模型,如 gpt-5.4-mini
CLAUDE_CODE_EFFORT_LEVEL 推理强度,max 质量最高、耗时最长
CLAUDE_CODE_AUTO_COMPACT_WINDOW 自动压缩窗口的 token 阈值

模型名需为 51token 实际支持的模型,完整列表见 模型与渠道。Claude Code 会把 ANTHROPIC_MODEL 指定的名字透传给 51token,因此请直接填 51token 的模型名(如 gpt-5.6-sol),不要填 claude-* 系列。

1.2 手动写入 ~/.claude/settings.json

这是用户级配置,适合长期使用。不要把真实密钥写入项目内 .claude/settings.json。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.caiaiu.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

1.3 vscode配置

VScode在插件中心搜索 claude code,认准是anthropic发布的,安装之后ctrl + shift +p打开视图窗口,输入open user settings json,打开settings.json配置文件:

json
{
 "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://51token.one/anthropic",
    },
    {
      "name": "ANTHROPIC_API_KEY",
      "value": "<你的API KEY>",
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "<你的API KEY>",
    },
  ]
}

2. 从零安装 Claude Code

1. 安装 Claude Code

有2种安装方式,就是优先使用官方安装脚本;如果你的环境更适合 npm,也可以按官方说明安装。

  • 安装 Node.js 18+。

  • Windows 用户需安装 Git for Windows。

  • 在命令行执行以下命令安装 Claude Code:

    • npm安装方式:
    bash
    npm install -g @anthropic-ai/claude-code
    
    • 官方脚本方式:

    Mac和Linux 的安装方式。

    bash
    curl -fsSL https://claude.ai/install.sh | bash
    

    Windows PowerShell 的安装方式。

    bash
    irm https://claude.ai/install.ps1 | iex
    

安装结束后,执行以下命令,若显示版本号则安装成功:

bash
claude --version

2. 配置环境变量

同「1. 从现有安装迁移到 51token」中的环境变量,按你的系统执行对应命令。

3. 进入项目目录,执行 claude

bash
cd /path/to/my-project
claude

3. 开始使用

配置完成后,在项目目录直接运行 claude 即可:

bash
cd /path/to/my-project
claude

启动信息显示 gpt-5.6-sol(或你设置的模型)即代表已接入 51token。

4. Web Search 功能

51token 的接口原生支持 Claude Code 的 Web Search 工具。当模型判断需要联网时,会调用 Web Search 并通过 51token 接口完成检索与总结。注意:Web Search 会产生额外的大模型 Token 消耗。

5. Claude Code / Desktop 的模型映射

在 Claude Code 或 Claude Desktop(developer 模式)中,只需把 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 指向 51token,再在 ANTHROPIC_MODEL 中填入 51token 的模型名即可,无需官方订阅即可使用对应模型。

本文档由 Markdown 自动生成,样式遵循 new-api 主题规范。