Claude Code 手动接入

本页适用于 Claude Code 命令行。第一次使用推荐 CC Switch 接入；这里提供手动配置的备用方式。Claude Desktop 使用单独的桌面端入口，见桌面端补充。

准备信息

先按 Claude Code 官方安装说明安装客户端。在终端运行 claude --version 能显示版本后，再继续配置。

先创建 API 密钥，选择支持 Claude Code 和所需模型的分组。建议与 Codex 使用不同密钥，例如 claude-code-work。

在 259AI API 密钥页面点击对应行的 “使用密钥”，选择 Claude Code 和你的系统，查看当前分组生成的接入配置。不同分组可能使用不同地址，优先采用弹窗展示的值。

项目	用途
`ANTHROPIC_BASE_URL`	控制台生成的 Claude Code 地址；普通根地址为 `https://api.259aitoken.com`
`ANTHROPIC_AUTH_TOKEN`	259AI API Key，用于 Bearer 鉴权
模型名	当前分组支持的模型名称

Claude Code 会自行拼接 /v1/messages，不要把该完整请求路径填入 Base URL，也不要照抄 Codex 手动配置里的 /v1 地址。

1. 写入本机用户配置

先备份现有文件，再用文本编辑器打开；文件不存在时可以创建：

系统	用户配置文件
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`
Windows 下的 WSL	WSL 内的 `~/.claude/settings.json`

将下面的 env 字段合并到已有配置中，把 YOUR_259AI_API_KEY 换成你的密钥，地址采用 “使用密钥” 弹窗中的值。已有 env 时修改对应项，保留其他设置，不要覆盖整个文件。

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.259aitoken.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_259AI_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

此文件会保存密钥，请仅保留在自己的设备上，不要放进项目仓库或共享文档。JSON 不允许注释和末尾多余逗号。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 与本站当前生成配置保持一致，会关闭客户端部分非必要流量，也包括自动更新；需要升级时按客户端官方方式手动更新。

2. 重启 Claude Code

退出原有会话，在终端运行：

claude

如需显式指定模型，可使用下面的方式；先将占位名称替换为当前分组支持的完整模型名：

claude --model "YOUR_CLAUDE_MODEL"

3. 做第一次测试

在 Claude Code 中输入 /status，核对 Anthropic Base URL 和鉴权来源；地址应对应本站配置。
新会话发送：“请只回复：连接成功。不要读取文件或执行命令。”，等待完整回复且没有报错。
回到 259AI 使用记录，按该密钥和请求时间核对模型与消耗。短消息测试按正常规则计费。

有回复却没有本站对应记录时，先检查旧环境变量、其他配置文件或当前供应商，确认实际启用的是 259AI。

常见排查

现象	先检查
认证失败 / 鉴权冲突	核对 Key 是否完整、启用，以及是否同时配置了其他 Token、API Key 或凭据助手；按控制台生成的一套配置使用
404 / 地址错误	Base URL 使用控制台提供的地址，不加完整 `/v1/messages`，不照抄 Codex 的 `/v1`
模型不支持	核对当前 Key 分组支持的完整模型名，避免沿用旧配置的默认模型
设置未生效	检查 JSON 格式和 `/status` 显示的配置来源，退出后重新启动
VS Code 扩展仍提示登录	扩展还有自己的配置入口，查看官方扩展接入说明；不要假定终端设置已覆盖扩展
中途断流 / 429	查看错误排查，保留请求时间和错误信息，降低并发后再试

参考：Claude Code 官方网关接入、官方设置文件说明。

Claude Code 手动接入 ​

准备信息 ​

1. 写入本机用户配置 ​

2. 重启 Claude Code ​