Claude Code 集成

本教程介绍如何让 Claude Code 使用第三方 Claude 兼容接口。

本文示例网关地址：https://direct.reachapi.ai。

1. 通用前置条件

开始前请先确认：

已准备 ReachAPI Key（例如：sk-xxxxxx）
网关已兼容 Claude Messages API（POST /v1/messages）
本机可用终端环境（Windows PowerShell / macOS Terminal / Linux Shell）

官方文档（安装与高级配置）：

Node.js 要求：

最低版本：18+
建议版本：LTS（20+）

说明：我们是通过 AWS API 使用 Claude 兼容能力，建议额外配置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"。由于 AWS API 的支持通常会有一定滞后，一些实验性功能可能暂不兼容。

2. Windows（推荐 PowerShell）

2.1 安装 Node.js 与 Claude Code

安装 Node.js LTS：

winget install OpenJS.NodeJS.LTS

验证：

node -v
npm -v

安装 Claude Code（官方推荐）：

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

Windows CMD 安装命令（可选）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

npm 全局安装（兼容方式，不优先）：

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

安装后验证：

claude --version
claude doctor

说明：Windows 原生环境建议安装 Git for Windows，详见 Windows 安装说明。

2.2 临时配置（仅当前会话生效）

$env:ANTHROPIC_BASE_URL="https://direct.reachapi.ai"
$env:ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
claude

2.3 持久化配置（推荐）

方式 A：写入 Claude Code 全局配置 %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

方式 B：使用 setx

setx ANTHROPIC_BASE_URL "https://direct.reachapi.ai"
setx ANTHROPIC_API_KEY "YOUR_REACH_API_KEY"
setx CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS "1"

执行后请重开终端。

方式 C：写入 PowerShell Profile

Add-Content -Path $PROFILE -Value '`
$env:ANTHROPIC_BASE_URL="https://direct.reachapi.ai"`
$env:ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"`
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"`
'
. $PROFILE

3. macOS / Linux / WSL

3.1 安装 Node.js 与 Claude Code

如果你使用 nvm：

nvm install --lts
nvm use --lts

或从 Node.js 官网安装。

验证：

node -v
npm -v

安装 Claude Code（官方推荐）：

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

npm 全局安装（兼容方式，不优先）：

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

安装后验证：

claude --version
claude doctor

3.2 临时配置（仅当前会话生效）

export ANTHROPIC_BASE_URL="https://direct.reachapi.ai"
export ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
claude

3.3 持久化配置（推荐）

方式 A：写入 Claude Code 全局配置 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

方式 B：写入 shell 配置文件

zsh：

echo 'export ANTHROPIC_BASE_URL="https://direct.reachapi.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"' >> ~/.zshrc
source ~/.zshrc

bash：

echo 'export ANTHROPIC_BASE_URL="https://direct.reachapi.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"' >> ~/.bashrc
source ~/.bashrc

4. 项目级配置（推荐）

对于单个仓库，建议使用项目级配置：.claude/settings.local.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

建议不要把该文件提交到代码仓库。

5. 可选：固定默认模型

临时设置（macOS / Linux / WSL）：

export ANTHROPIC_MODEL="YOUR_MODEL_ID"

临时设置（Windows PowerShell）：

$env:ANTHROPIC_MODEL="YOUR_MODEL_ID"

或写入 settings.json / settings.local.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID"
  }
}

6. 验证是否生效

macOS / Linux / WSL：

ANTHROPIC_BASE_URL="https://direct.reachapi.ai" \
ANTHROPIC_API_KEY="YOUR_REACH_API_KEY" \
claude -p "只回复：连接成功"

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://direct.reachapi.ai"
$env:ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"
claude -p "只回复：连接成功"

如果返回了模型输出，说明 Claude Code 已通过你的网关正常调用。

7. 常见问题排查

401 / 403 鉴权失败

检查 ANTHROPIC_API_KEY 是否正确
确认 Key 是否仍有效、是否有对应模型权限

404 / 路径错误

确认 ANTHROPIC_BASE_URL 为：https://direct.reachapi.ai
确认网关实现了 Claude 兼容路径：POST /v1/messages

流式输出异常

确认网关支持 text/event-stream（SSE）
检查中间层（CDN / WAF / 反向代理）是否缓冲了流式响应

Windows 上命令不生效

setx 后必须重开终端
同时配置了 settings 与系统环境变量时，检查是否有旧值覆盖
运行 claude doctor 查看当前环境诊断信息

无法连接到 Anthropic 服务 / ERR_BAD_REQUEST

如果你看到类似报错：

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Please check your internet connection and network settings.

Note: Claude Code might not be available in your country. Check
supported countries at https://anthropic.com/supported-countries

可按以下方式处理：

打开 ~/.claude.json
在 JSON 中添加一行："hasCompletedOnboarding": true,
保存后重新启动 Claude Code

请确保 JSON 格式合法（例如逗号位置正确）。

8. 官方参考

Claude Code 环境变量文档：环境变量
Claude Code settings 文档：设置说明

Claude Code 集成

On this page