Claude Code / Codex / Gemini CLI 三件套：装、配、用

AI 编程的主战场已经从聊天界面转移到 CLI——Claude Code、OpenAI Codex CLI、Google Gemini CLI 三家产品几乎同时把”在命令行里跑 Agent + 改代码 + 跑测试”做成了主流玩法。

但这三家风格完全不同：Claude 工程化强、Codex 后端硬核、Gemini 前端审美第一。这篇把它们的安装、配置、能力差异说清楚，帮你选对工具。

一、三家的”性格”对比#

graph TD T[选哪个 CLI?] --> A{任务类型} A -->|通用 Agent / 工程化项目| C[Claude Code] A -->|复杂后端 / 重构 / debug| G[Codex CLI] A -->|前端原型 / 文档 / 多模态| M[Gemini CLI]

Claude：自主性、工程化（有时候过度工程化）、不错的前端审美 + 后端逻辑。代价是自主性强可能不完全按你的要求走。适合作为普适性 Agent。

GPT / Codex：极强的提示词遵循、极强的逻辑思考、跨项目跨端工程任务一流。代价是对提示词功底要求极高、前端审美一般。适合后端、debug、重构。

Gemini：最长上下文（但召回率差，长上下文是数字大而已）、多模态理解 TOP1、前端审美无可置疑、会说好听话。代价是较高幻觉率 + 工具调用能力弱。适合对话、前端原型、吃文档吃图片。

二、安装#

2.1 Claude Code#

1
# 全局安装
2
npm install -g @anthropic-ai/claude-code
3

4
# 验证
5
claude --version
6

7
# 进入项目目录运行
8
cd your-project
9
claude

2.2 OpenAI Codex CLI#

1
npm install -g @openai/codex
2
codex --version
3

4
# 进入项目目录
5
cd your-project
6
codex

2.3 Google Gemini CLI#

1
npm install -g @google/gemini-cli
2
gemini --version

💡 三个都基于 Node.js，建议用 nvm 装 Node 20+，老版本 Node 跑会有奇怪错误。

三、API 配置#

3.1 用官方订阅（最省心）#

工具	订阅方式	月费
Claude Code	Claude Pro / Team	$20 /$ 25
Codex CLI	ChatGPT Plus / Pro	$20 /$ 200
Gemini CLI	Google AI Pro	$20

直接登录账号就能用，不用配 API key。

3.2 用 API key（按量）#

Claude Code：

1
export ANTHROPIC_API_KEY=sk-ant-xxx
2
claude

或者持久化写到 ~/.zshrc / ~/.bashrc。

Codex CLI：

1
export OPENAI_API_KEY=sk-xxx
2
codex

Gemini CLI：

1
export GEMINI_API_KEY=AIza-xxx
2
gemini

3.3 用第三方 API 网关（推荐）#

如果你用 New-API 这类自部署网关，三家都能接：

Claude Code 接 New-API：

1
export ANTHROPIC_BASE_URL=https://api.your-domain.com
2
export ANTHROPIC_API_KEY=sk-your-newapi-token

Codex CLI 接 New-API：

1
export OPENAI_BASE_URL=https://api.your-domain.com/v1
2
export OPENAI_API_KEY=sk-your-newapi-token

Gemini CLI 接 New-API：

走 OpenAI 兼容模式（如果 New-API 配了 Gemini 渠道）：

1
# 用 claude-code-router 或类似工具做协议转换

💡 优势：所有 CLI 共用同一套 key + 用量统计 + 模型映射，体验飞升。

四、Claude Code 关键功能#

4.1 Subagents（子 Agent）#

Claude Code 最强的功能。可以预定义一组”专精 Agent”，主 Agent 自动调度：

.claude/agents/<name>.md：

1
---
2
name: code-reviewer
3
description: 代码审查专家，发现 bug 和性能问题
4
tools: Read, Grep, Bash
5
model: opus
6
---
7

8
你是一个严苛的代码审查专家。每次审查时：
9
1. 找出 bug 和潜在问题
10
2. 标注严重级别
11
3. 给出修复建议

之后 Claude Code 会在合适的时候自动调用这个 subagent。

4.2 CLAUDE.md（项目记忆）#

在项目根放一个 CLAUDE.md：

1
# 项目说明
2

3
- 用 pnpm 不用 npm
4
- 测试框架: vitest
5
- 不要写注释，代码自解释
6

7
# 约定
8

9
- 所有 API 都在 src/api/
10
- 数据库迁移在 db/migrations/

Claude Code 会自动读这个文件作为长期记忆。

4.3 Plan Mode#

按 Shift+Tab 切到 Plan Mode：

Claude 只读不写，先规划
你确认后再切回 Edit 模式执行

适合复杂任务先对齐方案，避免改一半才发现思路错。

4.4 Hooks#

.claude/settings.json 里可以挂 Hook，每次工具调用前/后跑命令：

1
{
2
  "hooks": {
3
    "PostToolUse": [
4
      {
5
        "matcher": "Edit|Write",
6
        "hooks": [{ "type": "command", "command": "pnpm format" }]
7
      }
8
    ]
9
  }
10
}

每次改完文件自动跑 format，省心。

五、Codex CLI 关键功能#

5.1 工作模式#

1
# 默认交互式
2
codex
3

4
# 自动执行（不问，直接做）
5
codex --approval-mode auto-edit
6

7
# 完全自动（包括跑命令）
8
codex --approval-mode full-auto

⚠️ full-auto 会执行 shell 命令 —— 谨慎用，最好沙箱里跑。

5.2 模型选择#

1
# 用 GPT-5 系列
2
codex --model gpt-5
3

4
# 用 o-series（推理优先）
5
codex --model o3

5.3 适合 Codex 的场景#

复杂重构：跨多个文件的逻辑改动，Codex 的”先思考再动手”比 Claude 稳
难 bug 定位：让 Codex 给你 step-by-step 推理路径
算法实现：力扣中等以上难度，Codex 准确率更高

六、Gemini CLI 关键功能#

6.1 多模态输入#

1
# 直接给图片 / PDF
2
gemini "解释这张架构图" --file diagram.png
3
gemini "总结这份合同" --file contract.pdf

6.2 长上下文（200w token）#

1
# 直接喂整个仓库
2
gemini "review 这个项目的架构问题" --file-all

⚠️ 长上下文召回率差：放 100w token 进去，模型可能”忘了中间部分”，别盲信”放全部代码”。

6.3 适合 Gemini 的场景#

快速原型 UI：要个 landing page、卡片设计、表单
文档总结：长 PDF、整本书的总结
多模态分析：图片、视频帧、PDF 表格

七、CLI 管理工具#

每次手动切换不同的 CLI / API key 很烦。社区有几个管理工具：

7.1 CC Switch#

1
https://github.com/farion1231/cc-switch

GUI，菜单栏切换 Claude Code 的 API
多个 provider 一键切换
适合：经常切换官方订阅 / 自部署网关 / 朋友的 key

7.2 ccNexus#

社区项目，Claude Code 增强版的 CLI 管理。

7.3 Claude Code Hub#

1
https://github.com/ding113/claude-code-hub

多 key 池 + 自动调度
适合：团队共享 Claude Code 接入

八、典型工作流：三个 CLI 配合用#

实际生产里我经常三个一起用，按任务分：

场景	用哪个
写新 feature（小）	Claude Code（自主性高，少操心）
写新 feature（大型重构）	Codex 先出方案 → Claude Code 执行
难 bug 定位	Codex（逻辑推理强）
前端组件 / 页面	Gemini（审美 + 速度）
文档阅读 + 总结	Gemini（多模态 + 长上下文）
Code Review	Claude Code（工程视角好）
算法题	Codex（数学/逻辑强）

九、共通技巧#

9.1 指定 working directory#

三家都支持 cd 到项目目录再启动。不要在用户家目录直接跑，否则可能误改 shell 配置文件。

9.2 用 git 做安全网#

1
# 每次让 AI 改之前 commit
2
git add . && git commit -m "before AI"
3

4
# 改完不满意一键回退
5
git reset --hard HEAD~1

9.3 让 AI 跑测试 = 双保险#

让 AI 跑 pnpm test 验证它自己的改动。三家都支持。

9.4 上下文复用#

工具	复用方式
Claude Code	`CLAUDE.md`
Codex	`AGENTS.md` 或自定义提示
Gemini	`.gemini/config.yaml`

十、踩坑清单#

现象	工具	原因
拒绝执行某些命令	全部	沙箱限制，加 `--dangerously-skip-permissions` 慎用
拉模型超时	全部	中国网络问题，配代理
token 烧得快	Claude / Codex	大型项目长会话，频繁清空上下文
改了一堆文件不知道改了啥	全部	用 git，每次 commit
Gemini 输出英文	Gemini	prompt 加 “回答用中文”
Codex 不按 instruction 走	Codex	prompt 不够详细，提示词功底要求高

十一、几条实用经验#

三家都装上：免费额度都不小，组合用最爽。
API 走 New-API 网关：统一管理 + 模型映射 + 用量统计。
简单任务 Claude，复杂任务 Codex：Claude 自主性强但有时偏题，Codex 跟提示严格但反应慢。
Gemini 当”读图器” + “原型机”：写真正代码不靠它，但出原型快。
CLAUDE.md / AGENTS.md 项目根放一个，省 80% 的重复 prompt。
配合 git：所有 AI 改动 commit 留痕，可回退。
大型项目用 subagents 拆分：主 Agent 调度 + 各 sub 专精，token 利用率最高。

三个 CLI 一起用熟之后，写代码体验比单纯 Cursor / Copilot 高一个层级——主动性 + 多步任务 + 长程上下文都不一样。