编程工具
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 配置问题。
推荐的配置顺序
- 在统一配置引导中选择模型,再选择或创建匹配密钥;默认推荐 CC Switch,手动方式使用下列配置。
- 在当前终端设置
ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN和ANTHROPIC_MODEL。 - 运行
claude后先发送短消息,确认终端可以收到回复。 - 再进入一个无敏感信息的测试目录,验证文件读取和工具调用。
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与日志功能记录对照,不要分享密钥和完整请求内容。