文档

Claude Code

安装 Claude Code，并通过 settings.json 配置 TokenPlan。

本文介绍如何在 Claude Code 中，通过 Anthropic Messages 兼容接口接入有道 TokenPlan。使用方式可参考 Claude Code 官方快速开始。

准备工作

安装 Node.js v18.0 或更高版本。
Windows 用户安装 Git for Windows 并在 Git Bash 中执行命令。
已开通有道 TokenPlan 并创建 API Key。还没有 Key？请先前往控制台创建 API Key 。

安装 Claude Code

在终端中执行以下命令安装 Claude Code：

npm install -g @anthropic-ai/claude-code

执行以下命令检查安装结果。若显示版本号，则表示安装成功。

claude --version

配置接入凭证

新建或编辑以下配置文件：

macOS / Linux：~/.claude/settings.json
Windows：C:\Users\<用户名>\.claude\settings.json

将 YOUR_API_KEY 替换为有道 TokenPlan API Key。如果还没有 Key，请先前往控制台创建 API Key ：

{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://openapi.youdao.com/llmgateway/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
  }
}

配置说明

hasCompletedOnboarding 设置为 true，用于跳过 Anthropic 官方登录验证。
模型名称后的 [1m] 用于开启 1M 上下文窗口，同时需要通过 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设置压缩窗口大小。
Claude Code 会按 Haiku、Sonnet、Opus 等角色选择模型。示例将 Haiku 映射到轻量模型，其余角色和子 Agent 统一使用 deepseek-v4-pro[1m]，可按任务复杂度调整。
将 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 设置为 1，可关闭后台匿名遥测请求，避免额外消耗 Token。

更多环境变量说明请参考 Claude Code 官方环境变量文档。

验证配置

修改配置文件后需要新开一个终端窗口，再执行 claude。发送一条对话并确认能够正常返回，即表示接入成功。

更新与排障

如果配置后仍然无法使用，可能是 Claude Code 版本过旧。执行以下命令更新到最新版本后重试：

npm install -g @anthropic-ai/claude-code@latest