Toodoo AI
进入控制台
文档
编程工具

Claude Code

通过 Anthropic 兼容网关配置 Claude Code。

先在统一配置引导中选择模型和协议,再选择或创建匹配密钥。引导会提供可复制配置;支持 CC Switch 的 CLI 优先使用 CC Switch。

准备条件

目标模型和渠道需要支持 Claude Code 所需的 Anthropic Messages、流式响应与工具调用。仅能运行普通文本对话,不足以证明编程流程可用。

配置当前终端

先按 快速开始 设置 TODOOAI_API_KEY,然后在同一个 PowerShell 终端中运行:

$env:ANTHROPIC_BASE_URL = "https://toodooai.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:TODOOAI_API_KEY
$env:ANTHROPIC_MODEL = Read-Host "输入支持 Messages 的完整模型 ID"
claude

这里填写服务根地址,不附加 /v1/messages。同时设置网关地址和网关凭据;只更换地址不会自动替换已有登录凭据。Claude Code 官方网关说明

验证和排障

先在测试目录中发送简单问候,再尝试读取一个无敏感内容的文件。若客户端仍使用旧配置,检查已有环境变量、登录状态和配置文件。

出现模型或工具调用错误时,核对所选模型的协议能力。不要通过关闭工具权限检查来解决 API 配置问题。

推荐的配置顺序

  1. 在统一配置引导中选择模型,再选择或创建匹配密钥;默认推荐 CC Switch,手动方式使用下列配置。
  2. 在当前终端设置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_MODEL。
  3. 运行 claude 后先发送短消息,确认终端可以收到回复。
  4. 再进入一个无敏感信息的测试目录,验证文件读取和工具调用。

Claude Code 的 Base URL 是 https://toodooai.com,不要在这里追加 /v1 或 /v1/messages。如果工具版本提供设置页面,优先确认页面最终显示的 URL 与环境变量一致。

配置优先级与清理旧设置

如果修改环境变量后仍然访问旧服务商,按下面顺序检查:

  • 当前 PowerShell 是否真的包含新的 $env:ANTHROPIC_BASE_URL;
  • 用户级或项目级配置文件是否覆盖了环境变量;
  • Claude Code 是否仍处于其他账号登录状态;
  • 是否启动了修改变量前就已经打开的旧终端进程。

完成检查后重新打开终端,并用最小请求重试。不要同时保留多套不确定的 Base URL。

常见错误

现象处理方向
401重新复制完整密钥,确认使用 ANTHROPIC_AUTH_TOKEN,并检查密钥是否启用。
404删除地址末尾多余的 /v1/messages,让 Claude Code 自己拼接路径。
模型不存在从 GET /v1/models 重新复制模型 ID,并确认当前分组可用。
普通问答成功、工具调用失败当前模型或渠道可能只支持文本,不支持 Claude Code 需要的工具协议。

将报错时间、状态码和脱敏后的模型 ID与日志功能记录对照,不要分享密钥和完整请求内容。

本页内容