CLI 配置

本页整理 CatAPI 的手动 CLI 配置路径，适合不使用 CC-Switch 的场景。参考：CLI 配置。

通用检查

开始前确认：

  • 已安装目标 CLI。
  • 已创建 CatAPI API Key。
  • 当前终端可以访问 https://api.catapi.com。
  • 模型名来自对应分组。

Claude Code

Claude Code 通常读取 Anthropic 兼容环境变量：

export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://api.catapi.com"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

写入 shell 配置文件后，重新打开终端或执行 source 让配置生效。

Codex CLI

Codex CLI 通常使用 OpenAI 兼容配置。不同版本的 Codex CLI 配置文件位置和字段可能不同，核心值保持一致：

model = "gpt-5-codex"

[model_providers.catapi]
name = "CatAPI"
base_url = "https://api.catapi.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

同时在环境变量中提供令牌：

export OPENAI_API_KEY="sk-your-api-key"

如果你的 Codex CLI 版本使用 profile，请把模型和 provider 绑定到当前 profile。

常见配置错误

现象优先检查
401 / unauthorizedAPI Key 是否完整、是否写错环境变量名。
404 / model not found模型名是否属于当前工具对应分组。
仍请求官方接口Base URL 是否被旧配置覆盖。
CLI 不读取新值是否重启终端或重新加载 shell 配置。
请求超时本地网络、代理、DNS 或防火墙设置。

安全建议

  • 不要把令牌写进仓库。
  • 不要把包含令牌的终端截图发到公开渠道。
  • 为不同工具创建不同令牌，便于停用和定位消耗。