Claude Code 接入

先说结论

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

可用接口是：

POST /v1/messages

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

1. 安装前准备

按 Claude Code 官方文档，命令行安装方式依赖 Node.js 和 npm。

最低要求：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.js 和 npm。

如果你不想先手动装 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://aiapi.aisonnet.org"
export ANTHROPIC_API_KEY="codex_your_api_key"

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

{
  "env": {
    "ANTHROPIC_API_KEY": "codex_xyz",
    "ANTHROPIC_BASE_URL": "https://aiapi.aisonnet.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 里的推荐使用方式。

常见做法是：

在 VS Code 扩展市场搜索 Claude Code 并安装官方扩展。
或者直接在 VS Code 集成终端里运行 claude，扩展会自动安装。
如果你是从外部终端启动，也可以在 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 扩展，只要扩展面板里能正常开始会话，通常也说明这套配置已经生效。

Claude Code 接入 ​

推荐方式 ​

先说结论 ​

1. 安装前准备 ​

2. 安装 ​

3. 推荐配置 ​

4. VS Code 扩展 ​

5. 请求头与鉴权 ​

6. 验证 ​

Claude Code 接入

推荐方式

先说结论

1. 安装前准备

2. 安装

3. 推荐配置

4. VS Code 扩展

5. 请求头与鉴权

6. 验证