跳至正文
文档目录
工具接入

Claude Code 接入

通过 Anthropic Messages 兼容入口将 Claude Code 连接到 CR 网关。

在 API Key 页面创建或复制完整 API Key,用它替换本页的 API_KEY。API Key ID、前缀和管理 Token 不能用于模型调用。

配置 Claude Code

下面的命令适用于 macOS、Linux 和 WSL。将 OPUS_MODEL、SONNET_MODEL、HAIKU_MODEL 替换为模型目录中支持 Anthropic Messages、流式输出和工具调用的模型名称;三项可以使用同一个模型。

替换 API_KEY 和模型名称后,复制整段到终端执行。命令会创建或覆盖 ~/.claude/settings.json;如果已有自定义配置,请先备份。

mkdir -p ~/.claude && cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.creative-reasoning.com",
    "ANTHROPIC_AUTH_TOKEN": "API_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "OPUS_MODEL",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "SONNET_MODEL",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "HAIKU_MODEL",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  },
  "model": "sonnet"
}
EOF

sonnet 是 Claude Code 的客户端选项,使用 ANTHROPIC_DEFAULT_SONNET_MODEL 配置的模型。需要默认使用 Opus 时,将 model 改为 opus。API Key 已写入用户配置,启动时直接运行:

claude

启动并验证

  1. 启动 Claude Code,然后运行 /status,确认当前模型。
  2. 完成一个短任务,验证流式输出和一次工具调用。
  3. 如果请求失败,按错误处理与重试保留状态码、模型名称和 CR 请求 ID。

Claude Code 配置约束

  • 接入 CR 时,保留 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 为字符串 "1"。它关闭实验性的 anthropic-beta 请求头及 beta 工具字段,避免兼容入口拒绝不支持的字段。详见 Claude Code 环境变量说明。
  • settings.json 是标准 JSON,不能包含注释。
  • ANTHROPIC_BASE_URL 只填写 HTTPS API Base URL,不追加 API 路径。
  • 只有模型详情明确支持 1M 上下文时,才可在 ANTHROPIC_DEFAULT_OPUS_MODEL 或 ANTHROPIC_DEFAULT_SONNET_MODEL 的值后追加 [1m];不要用于 ANTHROPIC_DEFAULT_HAIKU_MODEL。

图片与视频 Skill

需要让 Claude Code 或 Codex 用自然语言生成、编辑图片和视频时,安装 cr-media Skill。该指南包含插件与 npx skills 安装、升级、API Key 配置,以及本地参考图和 URL 的使用限制。

维护:CR Platform