一键配置脚本
一条命令完成 Claude Code / Codex 的接入配置：测速选域、写入配置、安装 CLI、连通验证，全程无需 sudo / 管理员权限
一键配置脚本¶
用一条命令完成从零到可用：脚本自动测速选择最快接入域、引导输入密钥、写入配置、按需安装 Node.js 与 CLI，最后发一条最小请求验证连通。先选你的操作系统：
📖 运行前请先在 QCode.cc 控制台 准备好
cr_开头的 API 密钥；脚本运行中会提示粘贴（输入不回显）。
🍎 macOS / 🐧 Linux¶
打开终端，粘贴运行（不需要 sudo）：
Claude Code¶
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
Codex¶
curl -fsSL https://qcode.cc/install/codex.sh | bash
配置写入 shell 配置文件（~/.zshrc / ~/.bashrc 托管块）或 ~/.codex/；缺 Node.js 时用 nvm 装在用户目录。
🪟 Windows¶
原生 PowerShell 即可——不需要 WSL，不需要管理员权限。 打开「Windows 终端」或 PowerShell，粘贴运行：
Claude Code¶
irm https://qcode.cc/install/claude-code.ps1 | iex
Codex¶
irm https://qcode.cc/install/codex.ps1 | iex
Windows 版说明：
- 配置写入用户级环境变量（Codex 写
%USERPROFILE%\.codex\），旧值自动备份到%USERPROFILE%\.qcode\ - 缺 Node.js 时用 winget 安装 LTS；没有 winget 会给出 nodejs.org 手动安装指引
- 配置完成后，新开的 PowerShell / 终端自动生效；VS Code 等编辑器需要重启一次
- 如果提示脚本被执行策略拦截，先执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser再重试
脚本做了什么¶
- 测速选域 —— 对 api / asia / us / eu 四个接入域各发一次轻量请求，推荐最快项（可手动改选）
- 写入配置 —— Claude Code：macOS/Linux 写 shell 托管块、Windows 写用户级环境变量；Codex：写
~/.codex/config.toml+auth.json（默认模型现场可选，推荐gpt-5.6-terra） - 安装环境（可跳过）—— 检测 Node.js ≥ 20，缺失时用 nvm（macOS/Linux）或 winget（Windows）安装 LTS，再
npm install -g安装 CLI；全程用户目录 - 连通验证 —— 用你的密钥发一条最小请求，失败时按 HTTP 状态码给出定向排错提示
- 写前备份 —— 所有被修改的文件先备份为
.bak.时间戳；Windows 旧环境变量备份到%USERPROFILE%\.qcode\
非交互模式（CI / 免确认）¶
macOS / Linux：
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --key cr_xxx --yes
| 参数 | 说明 |
|---|---|
--key <cr_...> |
API 密钥，提供后跳过交互输入 |
--domain <api\|asia\|us\|eu> |
指定接入域，跳过测速 |
--model <id> |
（仅 codex.sh）指定默认模型，跳过选单 |
--yes / -y |
所有确认取默认值 |
--no-install |
只写配置，不安装 Node / CLI |
--no-verify |
跳过连通验证 |
--help |
查看全部参数 |
Windows 带参调用（参数与上表对应：-Key、-Domain、-Model、-Yes、-NoInstall、-NoVerify）：
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Key cr_xxx -Yes
（codex.ps1 同理）
写入了哪些文件 / 如何回滚¶
| 工具 / 平台 | 写入位置 | 回滚方式 |
|---|---|---|
| Claude Code（macOS/Linux） | ~/.zshrc 或 ~/.bashrc 中的 # >>> qcode.cc claude-code >>> 托管块 |
删除整个托管块，或用同目录 .bak.时间戳 备份还原 |
| Claude Code（Windows） | 用户级环境变量 ×3 | 用 %USERPROFILE%\.qcode\backup-*.json 中的旧值还原 |
| Codex（全平台） | ~/.codex/config.toml + ~/.codex/auth.json |
用同目录 .bak.时间戳 备份还原 |
重跑脚本总是安全的：托管块原地更新，配置文件先备份再覆盖。
常见问题¶
- 验证返回 401 —— 密钥无效或过期：到 控制台 核对（确认
cr_前缀完整复制）后重跑脚本 - 验证返回 404 —— 接入地址错误：Claude Code 的 BASE_URL 应为
https://{域}/api、Codex 为https://{域}/openai，且末尾不带斜杠 - 网络超时 —— 重跑脚本换一个接入域（如
--domain asia）；各域实时状态见 probe.qcode.cc - Windows 上装完找不到 claude / codex 命令 —— 重开一个新的 PowerShell 窗口（PATH 在新会话才刷新）
- 不想让脚本装 Node —— 加
--no-install（Windows：-NoInstall），只写配置 - 想先看脚本内容 —— 直接打开 https://qcode.cc/install/claude-code.sh 阅读源码；脚本不需要 sudo / 管理员权限，不写任何系统目录