跳到主要内容

Claude Code 接入 TonyAI

Claude Code 的服务地址填 https://tonyai.link,不要加 /v1 本篇使用 Claude 模型;接口格式名为 Anthropic Messages。先准备明确支持 Claude Code 的 TonyAI Key

1. 安装 Claude Code

打开终端,执行自己系统对应的官方安装命令。

macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex

等待安装结束,关闭并重新打开终端,再输入:

claude --version

能显示版本号,就可以继续。若找不到命令,按安装结果提示处理;更多安装条件见 官方安装指南

2. 填写用户配置

先按 打开 Claude Code 配置文件 操作。文件默认位于:

系统默认位置
macOS / Linux~/.claude/settings.json
Windows%USERPROFILE%\.claude\settings.json

文件只有 {} 或为空时,替换为下面整段内容。将 YOUR_TONYAI_API_KEY 换成自己的 Key,将 YOUR_CLAUDE_MODEL_ID 换成完整 Claude 模型 ID。保留英文引号、逗号和大括号,配置粘贴到文件里。

{
"model": "YOUR_CLAUDE_MODEL_ID",
"env": {
"ANTHROPIC_BASE_URL": "https://tonyai.link",
"ANTHROPIC_AUTH_TOKEN": "YOUR_TONYAI_API_KEY"
}
}

已有配置先备份。已有 model 就修改它;已有 env 就在这个对象中修改或添加上述两项,保留其他设置,不要直接在末尾追加一整段。修改完保存文件,具体见 已有配置的修改方法。这里使用的是用户配置,不要把含真实 Key 的内容写进可共享的项目配置。

ANTHROPIC_AUTH_TOKEN 会作为 Bearer 凭证发送。无需在 Key 前加 Bearer ,也不要同时填写另一把 ANTHROPIC_API_KEY

3. 重启并测试

关闭旧的 Claude Code 会话。在终端执行对应命令,创建并进入测试文件夹,再启动工具:

macOS / Linux:

mkdir -p ~/TonyAI-Test
cd ~/TonyAI-Test
claude

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\TonyAI-Test" | Out-Null
Set-Location "$env:USERPROFILE\TonyAI-Test"
claude

如有信任文件夹的提示,确认是测试文件夹后继续。以后在要处理的文件夹中运行:

claude

在 Claude Code 的对话输入框中输入 /status 并回车,检查服务地址是否为 TonyAI,模型是否与你填写的一致。新建会话输入「只回复 OK」,然后到 TonyAI 使用记录 核对请求。再按 文件操作测试 创建测试文件。

常见问题

现象先检查什么
401 / 未授权Key 是否完整、有效,是否同时配置了其他认证方式
404 / 找不到接口Base URL 是否误加了 /v1/messages
模型不可用当前分组是否支持填写的 Claude 模型 ID
重启后仍用旧模型是否恢复了旧会话,或项目配置覆盖了用户的 model

本篇按官方 Claude 模型接入方式编写。若你选的是名称带「国模」的分组,请先确认它对 Claude Code 的具体支持情况,不能把分组名当成 Claude 模型 ID。

依据:官方网关连接配置模型配置配置文件说明。核对日期:2026-09-07。