terminal
复制后合并到自己的配置；请在本地安全设置真实凭据。
claude --version
claude doctor正在打开页面…
正在加载内容，请稍候。
Claude Code 国内安装教程先按操作系统和官方安装方式准备 CLI，用 claude --version 确认版本，再选择登录或网关鉴权方式。连接后在独立目录完成一个小代码任务，检查文件差异、运行结果和请求记录。
资料核对：。核对官方安装、网关及认证文档；按入口限定配置范围，没有新增实时延迟、Claude Code 成功率或所有功能兼容实测。
配置前准备
- 按官方渠道完成本机安装并记录版本；原生安装不要求预装 Node.js。
- 确认原启动环境能访问 API 网关，复制当前令牌允许的准确型号和协议。
- 准备测试目录、自己的 Key 和小额预算；先备份旧环境变量与客户端设置。
按这四个阶段推进
- 1
安装：按 Windows、macOS、Linux 或 WSL 的专属教程完成独立 CLI 安装。官方地址下载失败与 API 连接失败是不同问题。
- 2
配置：CLI Messages 网关地址使用 https://api.apizt.com，自己的 Key 放在 ANTHROPIC_AUTH_TOKEN；VS Code 和桌面使用各自官方设置入口。使用 CC Switch 时由它管理供应商。
- 3
请求：核对当前模型与分组，再发送一个固定短问题。若没有对应调用记录，先检查实际配置来源；有记录则按错误正文排查认证、模型、余额和限流。
- 4
任务：在测试仓库实际读取一个文件、修改独立实现并运行测试。保存 diff，再独立复跑，区分代码建议与真实任务完成。
- 5
费用：合计该任务全部请求、缓存和重试，对照控制台实扣。缓存细分和 reasoning 字段按响应语义处理，不重复累加。
- 6
恢复：要返回官方登录时，先备份、关闭对应 CC Switch 路由、选择官方供应商并处理自身变量覆盖。API 与订阅始终分别管理。
核对本页配置字段与检查项
常见现象，直接定位到下一步
- command not found：先检查安装二进制和 PATH，没有发送模型请求。
- 401：确认真实 Key 来自目标服务，检查旧认证和进程环境。
- 404 / model not found：核对最终路径、调用 ID、协议与分组权限。
- 429：区分消费上限、速率和上游限制；余额够也不保证不会限流。
- 终端成功，编辑器失败：核对该入口是否读取相同配置以及功能支持，不反复换 Key。
查看相关型号
在型号详情中核对最低价格、参数、接口示例与使用限制，再选择配置方式。
Claude Opus 5.5
Claude Opus 5.5 API 从 Messages 短请求开始接入，再在 Claude Code 的测试仓库中验证文件读取、重试逻辑修改和测试执行。CLI 使用网关地址 https://api.apizt.com。
查看型号详情
Claude Sonnet 5.5
Claude Sonnet 5.5 API 从 Messages 的金额函数修复开始，随后在 Claude Code 中运行同一任务的测试。旧客户端自动附带的采样参数和强制工具选择应逐项核对。
查看型号详情
Claude Haiku 4.5
Claude Haiku 4.5 API 先用 Messages 把客服工单分类，顺序处理少量样本并保存 usage。请求保留日期快照 ID，缺字段和歧义工单进入人工检查后再扩大处理量。
查看型号详情
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
常见问题
Claude Code 原生安装一定需要 Node.js 吗？
依安装方式而定。先按当前官方安装说明选择原生或 npm 方式，再核对各自依赖；不要把 npm 的 Node.js 前置要求套用于所有安装方式。
Claude Code 安装成功后怎么测试代码任务？
在独立测试目录提供一个小文件和明确修改目标，查看实际文件差异并运行相应命令。同步核对请求记录；仅显示版本或输出一句问候不能证明代码任务完成。
国内接入应该先做哪一步？
先完成官方安装并验证命令，再配置独立 API，最后完成一个固定小任务。安装下载与模型请求不使用同一地址。
配置网关后所有 Claude Code 功能都一样吗？
不能统一保证。模型协议、工具、文件、MCP 和云端入口分别验证，客户端支持范围也可能不同。
第三方 API 能解除官方账号限制吗？
不能。API 是独立工作流；官方账号申诉、历史记录与订阅权益由 Anthropic 管理。
如何确认配置真的生效？
在原启动环境核对 /status、准确模型和请求记录，再验收实际输出与工具任务。仅保存配置或看到启动页不够。
能保证比其他网络方案更快吗？
本页没有相同任务和网络的延迟对比，不提供固定速度排名。用自己的原环境记录等待时间、结果和失败。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。