Claude Code 如何接入第三方 API
Claude Code 官方 CLI 支持通过环境变量指定 API 地址和鉴权方式。ClawSocket 提供 OpenAI 兼容入口,但 Claude Code 使用的是 Anthropic 风格变量,因此应优先按照客户端支持的 ANTHROPIC_* 配置来接入。
配置环境变量
在启动 Claude Code 的同一个终端执行:
export ANTHROPIC_BASE_URL="https://api.clawsocket.com"
export ANTHROPIC_AUTH_TOKEN="你的 ClawSocket Key"
claude部分版本使用 ANTHROPIC_API_KEY 作为凭证变量。如果设置 AUTH_TOKEN 后仍然提示未找到 Key,可以同时设置:
export ANTHROPIC_API_KEY="你的 ClawSocket Key"不要把这几行写入项目仓库的 .env 并提交。个人设备可以写入 shell 的本地配置文件,但共享机器应使用系统密钥管理工具。
选择模型
Claude Code 的模型可以通过启动参数、交互命令或环境变量选择,具体名称取决于你当前 CLI 版本和 ClawSocket 控制台的可用模型。例如:
export ANTHROPIC_MODEL="claude-opus-4-1"
claude如果控制台显示的是别的 API ID,使用控制台中的精确 ID,不要把页面展示名直接当成模型参数。更换模型后先做一次小范围代码阅读,再执行修改任务。
配置文件与项目隔离
Claude Code 会读取用户级和项目级设置。建议把“是否允许执行命令”“默认模型”等非敏感偏好写入配置,把 Key 保留在环境变量。为个人实验、团队项目和 CI 分别创建 ClawSocket Key,并设置不同的额度,便于审计和撤销。
常见报错
Invalid API key:确认变量名、Key 是否过期,以及 Claude Code 是否继承了当前 shell 的环境变量。重启 CLI 后再试。
Could not resolve host / timeout:检查网络和 Base URL,ClawSocket 地址不要加多余的 /v1;Claude Code 的 Anthropic 请求路径由客户端拼接。
模型不可用:模型 ID 必须是控制台实际开放的名称。不同账户、地区和额度可能看到不同列表。
上下文过长:先缩小工作区范围,避免把构建产物和依赖目录交给工具读取,并换用支持更长上下文的模型。
让调用更可控
Claude Code 能读取文件和执行命令,建议先用只读任务验证连接,再开启写入权限。为 Key 设置每日预算,观察 ClawSocket 的请求记录;遇到 429 时降低并发并采用指数退避,不要在终端里反复快速重启。
Anthropic 官方环境变量说明可参考Claude Code 文档,ClawSocket 的通用接入方式见从零接入大模型 API。
环境变量速查
| 变量 | 示例 | 用途 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.clawsocket.com | Anthropic 风格请求入口 |
ANTHROPIC_AUTH_TOKEN | ClawSocket Key | Bearer 鉴权凭证 |
ANTHROPIC_API_KEY | ClawSocket Key | 部分版本使用的备用变量 |
ANTHROPIC_MODEL | claude-opus-4-1 | 默认模型 API ID |
FAQ
Claude Code 可以使用 OpenAI 的 base_url 吗?
Claude Code 按 Anthropic API 的请求格式工作,应配置 ANTHROPIC_BASE_URL。ClawSocket 会在统一入口侧处理兼容,不建议把 OpenAI 的变量直接套到 Claude Code 上。
ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个?
以当前 CLI 版本的提示和文档为准。通常优先使用 ANTHROPIC_AUTH_TOKEN;若客户端仍提示缺少 Key,再设置 ANTHROPIC_API_KEY 并重启。
Claude Code 为什么提示模型不存在?
模型展示名不一定等于 API ID。请从 ClawSocket 控制台复制精确模型标识,并确认当前项目拥有该模型的额度和权限。
怎样避免 Claude Code 读取不该读取的文件?
缩小启动目录,排除依赖和构建目录,先用只读任务验证连接,再逐步开启写入或命令执行权限。