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。