GetRouter文档
  • 简体中文

    • Claude Code

    Claude Code 使用 Anthropic Messages 协议。它和 OpenAI 兼容工具的 Base URL 不同：应填写 GetRouter 服务根地址，不要附加 /v1。

    配置状态
    • 推荐协议： Anthropic Messages
    • 配置格式核对： 2026-07-15（Anthropic Claude Code 官方设置文档）
    • 运行验证： 待验证

    1. 安装

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

    2. 创建专用 Key

    在 API Keys 创建 claude-code-local，设置额度和模型限制。

    3. 配置环境变量

    macOS / Linux：

    export ANTHROPIC_BASE_URL="https://getrouter.ai"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

    然后启动：

    claude

    ANTHROPIC_API_KEY 会按 Anthropic 客户端方式发送 x-api-key，GetRouter 的 /v1/messages 支持该认证方式。

    4. 选择模型

    模型配置方式可能随 Claude Code 版本变化。请从模型目录复制兼容 Anthropic Messages 的模型 ID，并通过当前版本支持的模型设置或启动参数指定。

    不要把 OpenAI Chat 模型能正常调用，直接等同于它能在 Claude Code 中完整工作。

    最终请求路径

    POST https://getrouter.ai/v1/messages

    5. 验证

    1. 在测试项目中运行 claude；
    2. 先要求它只读取并总结文件；
    3. 在使用记录确认 Endpoint 为 /v1/messages；
    4. 再测试文件编辑、工具调用和长上下文；
    5. 确认额度和审批策略符合预期。

    常见问题

    现象处理
    401检查 ANTHROPIC_API_KEY 是否被当前进程读取
    404ANTHROPIC_BASE_URL 应为 https://getrouter.ai，不要重复 /v1
    仍打开官方登录清理冲突的登录配置，并从设置了环境变量的终端重新启动
    模型不可用确认模型 ID、Key 模型限制和 Anthropic Messages 支持
    Tool Calling 异常分别核对模型能力、Messages 工具格式和 Claude Code 版本

    安全建议

    Claude Code 能读取项目文件并执行命令。使用独立 Key、有限额度和保守权限；不要把 Key 写入仓库中的 .env 并提交。