接入 Claude Code
Claude Code 是运行在终端中的第三方 AI 编程助手。APIGATE 通过 Anthropic 兼容接口为其提供模型服务。
请从官方渠道安装 Claude Code。第三方工具的功能、安全策略和版本兼容性由其提供方负责。
已经安装 Claude Code
Linux / macOS
export ANTHROPIC_BASE_URL=https://apigate.online
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=YOUR_MODEL
export ANTHROPIC_DEFAULT_OPUS_MODEL=YOUR_MODEL
export ANTHROPIC_DEFAULT_SONNET_MODEL=YOUR_MODEL
export ANTHROPIC_DEFAULT_HAIKU_MODEL=YOUR_MODEL
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://apigate.online"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
$env:ANTHROPIC_MODEL="YOUR_MODEL"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="YOUR_MODEL"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="YOUR_MODEL"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_MODEL"
配置完成后进入项目目录：
cd /path/to/your-project
claude
从零安装
-
安装 Node.js 18 或更高版本。
-
Windows 用户同时安装 Git for Windows。
-
安装 Claude Code：
npm install -g @anthropic-ai/claude-code
-
确认安装成功：
claude --version
-
按上方系统对应的命令设置环境变量，然后进入项目目录运行 claude。
持久化配置
Linux 或 macOS 可以把 export 命令写入 shell 配置文件；写入前应确认该文件不会被同步或提交到公开仓库。更安全的方式是通过私有环境变量管理工具加载密钥。
Windows 可在系统环境变量中配置，但不建议在共享电脑保存长期有效的 API Key。
验证与排错
- 执行 claude 后出现 401：检查 ANTHROPIC_AUTH_TOKEN。
- 提示模型不可用：检查 ANTHROPIC_MODEL 是否与控制台模型名称完全一致。
- 请求路径错误：ANTHROPIC_BASE_URL 应为 https://apigate.online，不要追加 /v1。
- 更换密钥后仍使用旧值：关闭当前终端并重新打开，或重新执行环境变量命令。