选择语言
登录/注册

EcoToken

接入 Claude Code

通过 Anthropic Messages 兼容接口，让 Claude Code 使用 EcoToken 中可用的模型。

Base URL认证方式接口协议
https://ecotoken.ecophase-ai.comBearer API KeyAnthropic Messages

01 准备接入信息

开始前，请先在 EcoToken 控制台创建 API Key，并确认 API Key 所属分组可以访问你要使用的模型。

参数示例值
API KeyYOUR_API_KEY
模型 ID / 模型名称deepseek-v4.1-flash
不要把真实 API Key 写入代码仓库。 本文中的 YOUR_API_KEY 是占位符。建议使用环境变量，避免把 API Key 提交到 Git 或粘贴到公开渠道。

02 安装 Claude Code

如果本机已经安装，可以跳过安装命令，直接检查版本并进入配置步骤。推荐使用 v2.1.234 或更高版本。

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

03 方式一：EcoToken 工具配置

ecotoken 是一次性运行的本地配置工具，不是常驻代理。它会保留与模型提供商无关的现有设置，并在 ~/.claude/settings.json 中写入 EcoToken 地址、API Key 和模型。原文件需要修改时会备份为 ~/.claude/settings.json.ecotoken.bak。

bash
npm install -g @ecophase-ai/ecotoken
命令行历史可能保存 API Key。 更重视 API Key 安全时，直接运行 ecotoken 并通过交互菜单输入。

完全退出 Claude Code 后，可将同目录的 .ecotoken.bak 复制回原文件以恢复最近一次配置。首次配置前文件不存在时不会生成备份。

04 方式二：手动配置

Claude Code 会在 Base URL 后调用 /v1/messages，因此这里填写站点根地址，不要手动追加 /v1。

bash
export ANTHROPIC_BASE_URL="https://ecotoken.ecophase-ai.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"

05 启动并验证

进入项目目录后启动 Claude Code，发送一个简短问题。首次运行时，客户端可能要求确认项目目录和权限策略。

bash
cd /path/to/your-project
claude
接入成功的判断标准。 Agent 能返回模型内容，并且 EcoToken 控制台“用量与费用 → 请求记录”中出现对应记录，即表示 Base URL、API Key 和模型配置均已生效。

06 常见错误

  • 401：检查 API Key 是否完整、是否已停用，以及环境变量是否在启动 Claude Code 的同一个终端会话中生效。
  • 403：通常是 API Key 分组、模型权限、账户状态或入口策略不匹配。先在控制台确认该 API Key 可以访问所选模型。
  • model not found：模型名称必须和控制台中的模型 ID 完全一致，不要使用展示昵称、额外空格或其他平台的模型别名。
  • Base URL：Claude Code 使用 https://ecotoken.ecophase-ai.com，客户端会自行请求 /v1/messages；不要在 Base URL 中重复添加 /v1。
EcoPhase 文档 - 接入 Claude Code - EcoPhase.AI