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