AI 编程工具安装
Claude Code、Codex、Gemini CLI 安装配置与使用场景详解
这是一份面向新手的 AI 编程命令行工具安装指南。我们将帮你在电脑上装好当前最强的三个 AI 编程 CLI 工具,并配置好中转 API,让你可以用最低的成本获得最强的 AI 编程体验。
日常推荐组合:VS Code + Claude Code + Codex + Gemini CLI,根据不同场景切换使用。
三个工具分别擅长什么?(2026 年 1-2 月)
| 工具 | 擅长领域 | 一句话总结 |
|---|---|---|
| Claude Code | 综合能力最强 | 全能选手,复杂任务首选 |
| Codex | 后端代码最强 | 写 API、数据库、系统架构找它 |
| Gemini CLI | 前端代码最强 | 写 UI、组件、样式找它 |
三个工具都是在终端(命令行)中使用的 AI 编程助手,可以直接读取你的项目代码、执行命令、修改文件。
快速安装命令
前置条件
三个工具都需要 Node.js 环境。如果你还没装,先装 Node.js。
macOS / Linux
# 安装 Node.js(如果已安装可跳过)
# macOS 用 Homebrew
brew install node
# 或使用 nvm(推荐,方便管理多版本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install 22Windows
# 方法 1:直接下载安装包(推荐新手)
# 访问 https://nodejs.org/ 下载 LTS 版本,双击安装
# 方法 2:使用 winget
winget install OpenJS.NodeJS.LTSmacOS / Linux 一键安装三件套
# 1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 2. 安装 Codex
npm install -g @openai/codex
# 3. 安装 Gemini CLI
npm install -g @google/gemini-cliWindows 一键安装三件套
在 PowerShell 或 CMD 中执行以下命令即可:
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
npm install -g @google/gemini-cli安装完成后,验证是否成功:
claude --version
codex --version
gemini --version各工具详细说明
1. Claude Code — 综合能力最强
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它能理解整个项目上下文,执行复杂的多步骤任务,是目前综合能力最强的 AI 编程 CLI 工具。
适用场景:
- 复杂的跨文件重构
- 需要理解整个项目架构的任务
- 调试疑难 bug
- 编写测试、文档
- 几乎所有编程任务的首选
认证方式:
- 官方订阅:运行
claude后通过浏览器登录 Anthropic 账号 - API Key:设置环境变量
ANTHROPIC_API_KEY - 中转 API:通过 CC Switch 配置(见下文)
基本使用:
# 进入项目目录后启动
cd your-project
claude
# 然后直接用自然语言描述你的需求
# 例如:"帮我修复登录页面的表单验证 bug"2. Codex — 后端代码最强
Codex CLI 是 OpenAI 推出的命令行编程助手,基于 OpenAI 最新模型。在后端开发、API 设计、数据库操作等场景表现尤为突出。
适用场景:
- 后端 API 开发
- 数据库设计与查询优化
- 系统架构设计
- 服务端逻辑编写
认证方式:
- ChatGPT 订阅:运行
codex后通过浏览器登录 - API Key:设置环境变量
OPENAI_API_KEY
基本使用:
cd your-project
codex
# 例如:"帮我设计一个用户认证的 REST API"Codex 桌面 App(推荐新手):
OpenAI 还推出了 Codex 桌面应用,提供图形界面,支持多任务并行、Git 集成、内置终端等功能。对于不习惯命令行的新手来说更加友好。
- 目前支持 macOS(Apple Silicon)
- Windows / Linux 版本即将推出
- 需要 ChatGPT Plus/Pro/Business/Enterprise 订阅,或 OpenAI API Key
3. Gemini CLI — 前端代码最强
Gemini CLI 是 Google 推出的命令行 AI 编程助手,基于 Gemini 模型。在前端开发、UI 组件编写、样式调整等方面表现最佳。
适用场景:
- 前端 UI 组件开发
- CSS / Tailwind 样式编写
- React / Vue 组件开发
- 页面布局与响应式设计
认证方式:
- Google 账号:运行
gemini后通过浏览器登录(免费额度较多) - API Key:设置环境变量
GEMINI_API_KEY
基本使用:
cd your-project
gemini
# 例如:"帮我写一个响应式的导航栏组件"使用 CC Switch 配置中转 API
为什么需要中转 API?
- 官方 API 价格较高,中转服务通常有折扣
- 部分地区无法直接访问官方 API
- CC Switch 可以一键切换不同供应商,方便对比效果和成本
安装 CC Switch
CC Switch 是一款桌面应用,帮你统一管理 Claude Code、Codex、Gemini CLI 的 API 配置,一键切换供应商。
macOS(推荐 Homebrew):
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows:
前往 GitHub Releases 下载 .msi 安装包或 .zip 便携版。
Linux:
前往 GitHub Releases 下载 .deb / .rpm / .AppImage / .flatpak 对应格式。
推荐的中转 API 供应商
以下是 CC Switch 官方合作的中转 API 供应商,可根据需求选择:
| 供应商 | 优惠 | 注册链接 |
|---|---|---|
| 智谱 GLM | 九折,¥20/月起 | 注册链接 |
| PackyCode | 优惠码 cc-switch 九折 | 注册链接 |
| AIGoCode | 首充额外 10% | 注册链接 |
| AICodeMirror | 首充八折,企业七五折 | 注册链接 |
| Cubence | 优惠码 CCSWITCH 九折 | 注册链接 |
| DMXAPI | Claude 模型低至 3.4 折 | 注册链接 |
| AICoding.sh | 首充九折 | 注册链接 |
小白推荐:先试试 智谱 GLM(价格最低,¥20/月起)或 DMXAPI(Claude 模型折扣最大)。
CC Switch 使用流程
- 打开 CC Switch,点击 Add Provider 添加供应商
- 填入你在中转平台购买后获得的 API Key 和 Base URL
- 点击 Enable 激活配置
- 重启终端,让 CLI 工具读取新的环境变量
- 如需恢复官方登录,选择 Official Login 预设即可
更多详情请参考 CC Switch 详细文档。
日常使用建议
推荐工作流
VS Code(编辑器)+ 终端中运行 AI CLI 工具- 用 VS Code 打开项目
- 在 VS Code 内置终端中启动对应的 AI 工具
- 根据任务类型选择工具:
- 不确定用哪个?先用 Claude Code
- 写后端逻辑?用 Codex
- 写前端 UI?用 Gemini CLI
新手入门路径
- 第一步:先装好三个工具,用官方免费额度体验
- 第二步:确定常用后,安装 CC Switch 配置中转 API 降低成本
- 第三步:如果不习惯命令行,可以先用 Codex 桌面 App,有图形界面更友好
常见问题
Q:三个都要装吗? A:建议都装。它们各有所长,实际使用中你会自然形成偏好。如果只装一个,选 Claude Code。
Q:需要付费吗? A:三个工具本身免费安装。Claude Code 需要 Anthropic 订阅或 API Key;Codex 需要 ChatGPT 订阅或 OpenAI API Key;Gemini CLI 有较多免费额度。使用中转 API 可以大幅降低成本。
Q:Windows 能用吗? A:完全支持。在 PowerShell 中直接运行即可。Codex 桌面 App 目前仅支持 macOS,Windows 版即将推出。