Claude Code

Claude Code 通过 Anthropic Messages 接口工作。猫咖啡 API 已提供对应路由，Base URL 使用主域名，不要追加 /v1。

安装

macOS / Linux / WSL

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

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

npm

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

检查安装：

claude --version

配置文件

用户级配置位置：

• macOS、Linux、WSL：~/.claude/settings.json
• Windows：%USERPROFILE%\.claude\settings.json

创建或合并以下配置：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://coffeecatbox.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_MODEL": "控制台中的 Claude 模型 ID",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

ANTHROPIC_AUTH_TOKEN 会作为 Authorization: Bearer 发送，New API 可以识别。也可改用 ANTHROPIC_API_KEY，它会作为 x-api-key 发送。

不要提交用户密钥

建议把此配置放在用户目录，不要把含令牌的 .claude/settings.json 提交到项目仓库。项目共享配置中只放权限和规则，不放凭据。

启动与检查

在项目目录运行：

claude

进入后执行：

/status

确认 Base URL 和模型已经应用。也可以运行：

claude doctor

模型选择

• ANTHROPIC_MODEL 必须是控制台中支持 Claude Messages 的模型 ID；
• 工具调用、扩展思考和缓存能力取决于对应渠道；
• 自定义模型名未出现在模型选择器时，可直接通过环境变量固定；
• 模型拒绝某些 beta 参数时，可尝试设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。

常见问题

启动时要求登录

确认配置文件 JSON 有效，并且 ANTHROPIC_AUTH_TOKEN 非空。完全退出 Claude Code 后重新启动。

401 未授权

重新复制令牌，检查是否把引号、空格或换行一起粘贴进去。

模型不存在

当前模型不支持 Anthropic Messages，或令牌未授权该模型。回到模型广场核对。

工具调用异常

先更新 Claude Code，再换一个明确支持工具调用的 Claude 模型。代理网关无法支持的实验字段可通过兼容开关暂时关闭。