ExchangeToken

简体中文

English

简体中文

English

Appearance

在Claude Code中使用 ​

概述 ​

Claude Code 是 Anthropic 官方的命令行 AI 编程助手。将 Claude Code 的 API 网关配置为 ExchangeToken 后，可以通过统一入口调用 Claude、GPT、Gemini 等多种模型。

环境要求 ​

  • Node.js 18 及以上
  • ExchangeToken API Key，可在控制台的令牌管理页面创建或复制
  • 已安装 npm，或可执行 macOS / Linux 安装脚本

安全提醒

请不要把 API Key 写入公开仓库。团队项目建议使用本机环境变量或本机 Claude Code 配置文件管理密钥。

配置步骤 ​

安装 Claude Code ​

使用 npm 安装：

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

也可以在 macOS / Linux 上使用官方安装脚本：

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

使用配置文件（推荐） ​

创建 Claude Code 配置目录：

bash
mkdir -p ~/.claude

编辑 ~/.claude/settings.json：

bash
vim ~/.claude/settings.json

写入以下内容，并将 YOUR_EXCHANGETOKEN_API_KEY 替换为你的 ExchangeToken API Key：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.exchangetoken.ai",
    "ANTHROPIC_API_KEY": "YOUR_EXCHANGETOKEN_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

TIP

ANTHROPIC_BASE_URL 固定配置为 https://api.exchangetoken.ai。切换模型时只需要修改 ANTHROPIC_MODEL。

使用环境变量 ​

如果你更习惯通过 Shell 管理配置，可以在 ~/.bashrc、~/.zshrc 或其他 Shell 配置文件中加入：

bash
export ANTHROPIC_BASE_URL="https://api.exchangetoken.ai"
export ANTHROPIC_API_KEY="YOUR_EXCHANGETOKEN_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

修改后请重启终端，或执行与你的 Shell 对应的加载命令，例如：

bash
source ~/.zshrc

Windows 用户可以在系统环境变量中设置同名变量，然后重新打开命令提示符或 PowerShell。

切换模型 ​

修改 ANTHROPIC_MODEL 即可切换 Claude Code 使用的模型。

场景模型 ID说明
高性能claude-opus-4-7适合复杂推理、架构设计和长上下文任务
标准开发claude-sonnet-4-6适合日常编码、重构和调试
高性价比gemini-2.5-pro适合通用开发任务和成本敏感场景

切换到其他模型的配置示例：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.exchangetoken.ai",
    "ANTHROPIC_API_KEY": "YOUR_EXCHANGETOKEN_API_KEY",
    "ANTHROPIC_MODEL": "gemini-2.5-pro"
  }
}

TIP

建议优先选择支持工具调用（Tool Calling）的模型。可在 ExchangeToken 模型页面查看模型能力、价格和可用状态。

启动会话 ​

进入你的项目目录并启动 Claude Code：

bash
cd /path/to/your/project
claude

配置生效后，Claude Code 发起的请求会通过 ExchangeToken API 网关转发。

校验配置 ​

在 Claude Code 中运行 /status，检查当前认证方式、Base URL 和模型：

text
> /status
Auth token: ANTHROPIC_API_KEY
Base URL: https://api.exchangetoken.ai
Model: claude-sonnet-4-6

你也可以在 ExchangeToken 控制台查看用量或账单记录，确认请求是否已经到达平台。

故障排查 ​

API Error: Connection error ​

请检查 ANTHROPIC_BASE_URL 是否为：

text
https://api.exchangetoken.ai

同时确认当前网络可以访问 ExchangeToken API，并检查代理、防火墙或公司网络策略是否阻断了请求。

Auth token 无效或 401 ​

请确认 ANTHROPIC_API_KEY 使用的是 ExchangeToken API Key，且 Key 未被删除、禁用或超过额度限制。

env: node: No such file or directory ​

Claude Code 需要 Node.js。请安装 Node.js 18 或更高版本，并确认 node 在当前终端的 PATH 中：

bash
node -v

400 tools.*.custom.input_examples: Extra inputs are not permitted ​

这类错误通常与 Claude Code 版本或模型工具调用兼容性有关。建议先升级 Claude Code：

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