Claude Code、Codex 与 Gemini CLI：安装、配置与使用

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

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

一、三家的“性格”对比

mermaid5 行

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

plaintext10 行


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

# 验证
claude --version

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

2.2 OpenAI Codex CLI

plaintext7 行


npm install -g @openai/codex
codex --version

# 进入项目目录
cd your-project
codex

2.3 Google Gemini CLI

plaintext3 行


npm install -g @google/gemini-cli
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：

plaintext3 行


export ANTHROPIC_API_KEY=sk-ant-xxx
claude

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

Codex CLI：

plaintext3 行


export OPENAI_API_KEY=sk-xxx
codex

Gemini CLI：

plaintext3 行


export GEMINI_API_KEY=AIza-xxx
gemini

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

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

Claude Code 接 New-API：

plaintext3 行


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

Codex CLI 接 New-API：

plaintext3 行


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

Gemini CLI 接 New-API：

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

plaintext2 行


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

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

四、Claude Code 关键功能

4.1 Subagents（子 Agent）

Claude Code 最具代表性的一项功能。可以预定义一组“专精 Agent”，主 Agent 自动调度：

.claude/agents/<name>.md：

plaintext12 行


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

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

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

4.2 CLAUDE.md（项目记忆）

在项目根放一个 CLAUDE.md：

plaintext11 行


# 项目说明

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

# 约定

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

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

4.3 Plan Mode

按 Shift+Tab 切到 Plan Mode：

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

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

4.4 Hooks

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

plaintext11 行


{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "pnpm format" }]
      }
    ]
  }
}

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

五、Codex CLI 关键功能

5.1 工作模式

plaintext9 行


# 默认交互式
codex

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

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

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

5.2 模型选择

plaintext6 行


# 用 GPT-5 系列
codex --model gpt-5

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

5.3 适合 Codex 的场景

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

六、Gemini CLI 关键功能

6.1 多模态输入

plaintext4 行


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

6.2 长上下文（200w token）

plaintext3 行


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

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

6.3 适合 Gemini 的场景

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

七、CLI 管理工具

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

7.1 CC Switch

plaintext2 行


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

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

7.2 ccNexus

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

7.3 Claude Code Hub

plaintext2 行


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 做安全网

plaintext6 行


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

# 改完不满意一键回退
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 高一个层级——主动性 + 多步任务 + 长程上下文都不一样。

← 返回文章