AI 编程 CLI 安装指南
最后核验：2026-06-05。CLI 包名、安装命令和配置文件路径都可能变化，团队落地前请以各工具官方发布说明为准。
本栏目汇总 ETok 中所有 AI 编程工具链的安装与配置教程。
安装前先检查
大多数 AI 编程 CLI 安装问题都来自四个地方：Node.js 版本、npm 全局安装权限、环境变量缺失，以及写入永久变量后没有重新打开终端。先检查这些，再去排查模型服务商。
| 要求 | 为什么重要 | 如何验证 |
|---|---|---|
| Node.js 18+ | Claude Code、Codex、Gemini CLI 常见安装路径都依赖 npm | node --version |
npm 全局 bin 在 PATH 中 | 避免安装后出现 command not found | npm config get prefix |
| API Key 或中转 Key | CLI 第一次真实请求前必须有凭据 | 在同一个终端里 echo 对应环境变量 |
| Base URL 或服务商配置 | 使用 ETok 或其他中转时必须显式配置 | 设置后运行一个短提示词验证 |
安装教程
| 教程 | 覆盖内容 |
|---|---|
| Claude Code 安装与配置指南 | macOS、Linux、Windows 安装，Auth Token 与 BASE URL 配置 |
| Claude Code 节省 Token 配置 | Tool Search、自动压缩、禁用 1M 上下文与 settings.json 配置 |
| OpenAI Codex 安装配置指南 | Codex CLI 安装、API Key、BASE URL 与配置文件 |
| Windows 环境变量设置 | PowerShell、CMD、setx、GUI 四种环境变量配置方式 |
| 一键升级 AI CLI | 用 Bash 升级 Claude Code、OpenAI Codex、Gemini CLI |
按目标选择路径
| 你的目标 | 先读 | 然后读 |
|---|---|---|
| 在仓库里结对写代码 | Claude Code 安装与配置指南 | Windows 用户继续看 Windows 环境变量设置 |
| 降低 Claude Code 长会话成本 | Claude Code 节省 Token 配置 | CC Switch 管理多服务商配置 |
| 使用 OpenAI 模型做 Agent 编程 | OpenAI Codex 安装配置指南 | AI 大模型指南 选择模型 |
| 同时维护多个 CLI 最新版本 | 一键升级 AI CLI | CC Switch 管理服务商与配置 |
| 排查环境变量不生效 | Windows 环境变量设置 | 对应 CLI 的安装教程 |
推荐配置顺序
- 先从 AI 大模型指南 选择服务商。
- 安装匹配你工作流的 CLI。
- 配置 Token 与 BASE URL 环境变量。
- 用一个简单提示词验证工具可用后，再进入真实项目。
常见失败模式
command not found：包已经安装，但 npm 全局bin目录不在PATH。401或403：Key 缺失、过期、复制时带空格，或写入了 CLI 不读取的位置。404 model not found：模型名在当前服务商或中转里不存在。- 环境变量“不生效”：变量已写入永久配置，但当前终端没有重新打开。
- 安装下载慢：可以临时切 npm 镜像，团队环境里建议安装后恢复官方源。
常见问题
需要把所有 AI 编程 CLI 都安装一遍吗？
不需要。先安装一个 CLI，并在真实项目里验证可用；只有当你需要不同模型、多模态工作流或特定 Agent 能力时，再增加其他 CLI。
应该使用官方入口还是中转服务？
能直接用官方入口时，官方入口配置最简单。需要统一账单、区域路由、服务商容灾或团队网关时，再使用中转。
什么时候引入 CC Switch？
安装已经跑通后，如果重复工作变成配置管理，例如切服务商、同步 MCP、备份 CLI 配置或维护多个助手，就适合引入 CC Switch。