Skip to content

Claude Code 接入

推荐方式

建议使用 cc-switch 配置:https://github.com/farion1231/cc-switch/releases

  • 推荐先通过 cc-switch 处理 Claude Code 的接入配置
  • 配置完成后重启 claude

先说结论

当前服务已经支持 Anthropic Messages 兼容接口,可用于 Claude Code。

可用接口是:

  • POST /v1/messages

服务端会兼容 Claude Code 所需的 Anthropic 请求格式。

1. 安装前准备

按 Claude Code 官方文档,命令行安装方式依赖 Node.jsnpm

  • 最低要求:Node.js 18+
  • npm 通常会随 Node.js 一起安装
  • Windows 命令行环境下,官方建议优先使用 WSL

如果你准备按下面的 npm 方式安装 Claude Code,可以先到 Node.js 官方页面安装: https://nodejs.org/en/download

  • macOS / Windows:下载并安装 LTS 版本
  • Linux:按该页面提供的发行版方式安装

如果你在 macOS 上已经安装了 Homebrew,也可以直接执行:

bash
brew install node

这会同时安装 Node.jsnpm

如果你不想先手动装 Node.js,也可以改用 Claude Code 官方原生安装脚本:

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

建议先确认:

bash
node -v
npm -v

如果这两个命令还不可用,先安装 Node.js,再继续下面的 CLI 安装。

2. 安装

官方文档:https://docs.anthropic.com/en/docs/claude-code/getting-started

按 Claude Code 官方文档,常见安装方式是:

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

请不要使用 sudo npm install -g,避免额外的权限和环境问题。

如果你需要看平台差异、版本管理或卸载说明,可再参考官方安装页:https://code.claude.com/docs/en/setup

3. 推荐配置

优先使用 cc-switch 写入 Claude Code 配置。

如果你不用 cc-switch,可按 Claude Code 官方环境变量手动配置:

export ANTHROPIC_BASE_URL="https://enjoy.aigemini.org"
export ANTHROPIC_API_KEY="codex_your_api_key"

如果你希望把配置直接写到 Claude Code 的配置文件里,可放到 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_API_KEY": "codex_xyz",
    "ANTHROPIC_BASE_URL": "https://enjoy.aigemini.org",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "ANTHROPIC_REASONING_MODEL": "claude-opus-4-6"
  },
  "model": "claude-sonnet-4-6",
  "skipDangerousModePermissionPrompt": true
}

这样启动 claude 或使用 VS Code 扩展时,会共用同一套 Claude Code 配置。

然后启动:

bash
claude

TIP

这里的 ANTHROPIC_BASE_URL 应填写服务根地址,而不是 /v1/messages 的完整路径。Claude Code 会按 Anthropic Messages 规范访问对应接口。

4. VS Code 扩展

截至 2026-03-31,Anthropic 官方文档已经把 VS Code 扩展列为 Claude Code 在 VS Code 里的推荐使用方式。

常见做法是:

  1. 在 VS Code 扩展市场搜索 Claude Code 并安装官方扩展。
  2. 或者直接在 VS Code 集成终端里运行 claude,扩展会自动安装。
  3. 如果你是从外部终端启动,也可以在 Claude Code 里执行 /ide 连接到当前 VS Code。

Anthropic 官方同时说明,VS Code 扩展和 CLI 共用同一套 Claude Code 配置系统。

对当前网关来说,最稳妥的方式仍然是先按上面的环境变量配置好:

  • ANTHROPIC_BASE_URL
  • ANTHROPIC_API_KEY

然后在 VS Code 项目根目录的集成终端里启动 claude。这样扩展和 CLI 会共用同一套接入配置。

如果你还需要改扩展自身的界面或行为,可在 VS Code 设置里进入 Extensions / Claude Code 调整;如果要改共享行为,则看 ~/.claude/settings.json

5. 请求头与鉴权

Claude Code 会按 Anthropic 方式发送鉴权。该服务已兼容这类请求头。

在服务侧,如果请求里没有显式带 anthropic-version,会补默认版本头。

6. 验证

启动后可在 Claude Code 中执行:

text
/status

如果状态页显示已经使用自定义 ANTHROPIC_BASE_URL,并且能正常发起会话,就说明接入成功。

如果你使用的是 VS Code 扩展,只要扩展面板里能正常开始会话,通常也说明这套配置已经生效。

OpenAI-compatible gateway integration docs