Claude Code

适用说明

本文中的站点名称、文档域名、Claude 接口根地址、模型列表和令牌权限，都以你的后台配置为准。 Claude Code 接入时，通常需要准备三项信息：

Claude 接口根地址，例如 https://api.example.com
可用令牌，例如 sk-your-token
后台开放的模型名称，例如 claude-3-5-sonnet-latest

建议的连通性测试

Claude 接口 curl 示例

先用 Claude 兼容接口确认根地址和访问令牌可用。

curl

curl https://api.example.com/v1/messages \
-H "Authorization: Bearer sk-your-token" \
-H "Content-Type: application/json" \
-d '{"model":"claude-3-5-sonnet-latest","messages":[{"role":"user","content":"hello"}]}'

访问令牌

sk-your-token

Claude Root URL

https://api.example.com

安装 Claude Code

先安装官方 CLI。

bash

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

检查命令

确认安装后可以直接执行。

bash

claude --version

临时环境变量

macOS / Linux

临时写入当前终端会话。

shell

export ANTHROPIC_BASE_URL="https://api.example.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-token"
claude

PowerShell

当前 PowerShell 会话内临时生效。

powershell

$env:ANTHROPIC_BASE_URL="https://api.example.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-token"
claude

部分环境也可能读取 ANTHROPIC_API_KEY，如果你的工具链使用这个变量名，可以保持一致。

长期写入终端环境

把变量保留在 shell 配置里。

shell

export ANTHROPIC_BASE_URL="https://api.example.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-token"

重新启动 Claude Code

保存后重新打开终端，再启动命令。

bash

claude

接入说明

Claude Code 通常走 Claude Messages 协议，对应路径一般是 /v1/messages
ANTHROPIC_BASE_URL 通常填写服务根地址，不需要手动补 /v1/messages
模型名称取决于后台实际开放的模型

常见排查

1. 认证失败

确认令牌仍然有效，并且权限设置正确。

2. 模型不存在

说明你本地请求的模型名称，与后台真实开放的模型名称不一致。

3. 返回 404

通常是因为 ANTHROPIC_BASE_URL 写成了错误路径，优先检查是否填了完整接口根地址。

Claude Code

目录