摘要

Windows 新手从环境准备到 settings.json 一次跑通。这篇写给准备在 CSDN 搜索“Claude Code 国内使用”“Codex CLI 接入”“OpenAI 兼容 Base URL”的新手，重点是可复制步骤、验证顺序和踩坑提醒。本文依据 allcode.cc 首页、Docs、Models、Status、Plans，以及官方 Claude Code / Codex 安装指南整理；价格、模型和状态以官网实时页面为准。

官方资料依据

allcode.cc 首页将产品定位为 AI Gateway，并写明 Codex | Claude 统一接入网关。官方 Claude Code 指南要求 Node.js 18+，推荐 Git Bash；安装包为 @anthropic-ai/claude-code。配置位于 .claude/settings.json，ANTHROPIC_BASE_URL=https://allcode.cc。

操作步骤

1. 安装 Git Bash，并确认 Node.js 版本不低于 18。
2. 运行 npm install -g @anthropic-ai/claude-code；网络异常可按官方 FAQ 尝试 npm 镜像。
3. 在 allcode.cc 创建 API Key，并保存到安全位置。
4. 创建 %USERPROFILE%.claude\settings.json，写入模板并替换两处 YOUR_API_KEY。
5. 重启终端运行 claude，在测试目录完成验证。

配置示例

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://allcode.cc",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": { "allow": [], "deny": [] },
  "apiKeyHelper": "echo 'YOUR_API_KEY'"
}

验证与排错

验证时不要只看 claude 命令是否出现，还要确认一次真实请求能返回。若失败，先检查 settings.json 路径、两处 Key、Node.js 版本和终端是否已重启。常见错误按顺序看：403 先查 Key、余额和权限；429 降低并发、缩小上下文；502 先看 Status，再判断本地网络。

安全与限制

API Key 要像密码一样保存，任何持有者都可能消耗额度。不要把密钥、客户数据、生产日志、数据库连接串或未脱敏私有代码直接上传；团队使用时按工具拆 Key，方便追踪和撤销。建议先小额、低风险验证，再决定是否纳入日常工作流。