CLI 单轮确认
复现：记录 claude --version，在测试目录只问一道简短问题，不授权任何工具。
通过：得到有效文本并能在平台日志找到对应 Messages 请求。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
Claude Code 直连 Anthropic Messages 兼容网关时，ANTHROPIC_BASE_URL 填 https://api.apizt.com，令牌放在网关支持的凭据变量。CC Switch 接管时按其当前配置写入，不要再让旧环境变量覆盖。
适合在终端做代码解释和代理开发。需要文件读写、运行测试、MCP 或长期会话时，应在自己的测试仓库逐项验证，不能把单轮回答当成全部能力。
按真实任务判断是否可用
受控代码任务
复现：在独立测试仓库让 Claude Code 读取 README，再按批准范围编辑一个测试文件。
通过：分别记录读、写、最终答复和全部请求；出现中断也保留记录。
先选对协议和请求地址
原生 Claude Code 走 Messages，客户端会在服务根地址后请求 /v1/messages。CC Switch 若做协议转换，应单独确认转换入口与路由；不能把 Codex 的 Responses 基址直接交给 Claude Code。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
直连 Messages：
ANTHROPIC_BASE_URL=https://api.apizt.com
ANTHROPIC_AUTH_TOKEN=从 apizt 安全配置的令牌
模型：令牌授权且支持 Messages 的完整 ID
CC Switch 接管：使用其当前提供商配置，并清查旧环境变量覆盖这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 Claude Code 经 apizt 配置与验证清单照这个顺序接入
- 01
确认谁管理路由
先确定是直接环境变量还是 CC Switch。不要同时让两套配置互相覆盖；记录实际运行的 Claude Code 版本。
- 02
配置 Messages 与认证
直连填根域名，凭据按网关支持的方式配置。仅修改 Base URL 不会自动将订阅登录切到 API 令牌。
- 03
由单轮扩展到工具
短问答成功后再验证读文件、编辑、测试和 MCP；每一种能力记录独立结果与请求费用。
对照工具配置与验证顺序
验证到哪一步？
2026-09-28：macOS 26.3、Claude Code 2.1.177、claude-sonnet-5；算术题通过 apizt Messages 返回 4。
- 现有依据
- Claude Code CLI 单轮文本已真实验证
- 验证边界
- 该记录没有覆盖工具执行、多轮、桌面版或 CC Switch 本地代理；另一次标记提示曾拒答。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
这个工具的费用怎样算
Claude Code 代理任务涉及多轮上下文、工具前后请求及失败重试；按所用模型分组、缓存、输出和完整账单统计。订阅额度与 apizt API 余额分别管理。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| 401 / Invalid API Key | 当前进程凭据来源不对或旧令牌生效。 | 核对配置来源与平台请求日志，不输出密钥正文。 |
| 切换 CC Switch 后仍请求旧地址 | shell 或项目 settings 中残留的 ANTHROPIC_BASE_URL 覆盖了新路由。 | 检查最终请求目标和进程环境，重启客户端。 |
| 文本成功，工具失败 | Messages 工具调用或目标模型能力尚未验证。 | 用只读测试仓库复现首个工具调用并记录脱敏响应。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
新会话只问“只回复 OK”，确认平台收到对应 Messages 请求；再授权读取测试 README。记录版本、请求时间与脱敏错误，不把终端 API 成功写成客户端实测。
查看 Claude Code 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
CC Switch 切换成功为什么 Claude Code 仍连不上？
切换完成只说明配置操作已执行。检查目标提供商是否用于 Claude Code、环境与项目设置是否覆盖，以及旧进程是否仍读取旧配置；重启后核对 Messages 请求。
Claude Code 中转地址可以照抄 Codex 配置吗？
不能。Claude Code 网关接入核对 Anthropic Messages 和 ANTHROPIC_BASE_URL，Codex 则按其 Provider 与 wire_api 配置。两者地址和鉴权字段分别确认。
Claude Code 应该填写哪个 API 地址？
apizt 的 ANTHROPIC_BASE_URL 使用 https://api.apizt.com，模型调用应到 /v1/messages。不能把 Chat Completions 或 Responses 地址当作 Claude Code 接口。
终端请求成功，为什么客户端仍然失败？
仅改 Base URL 不代表已更换登录凭据。遇到 401 应核对当前有效认证方式；403 则结合正文查权限或访问限制。 CC Switch 显示切换完成不等于模型调用已成功。文字、工具调用及其他高级能力要分别验证。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。