weidas Blog
主页 归档 关于
主页
归档
关于

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

weidas 2025-07-19 #Claude Code#Codex#Gemini CLI#AI#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 CodeClaude Pro / Team$20 / $25
Codex CLIChatGPT Plus / Pro$20 / $200
Gemini CLIGoogle 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 ReviewClaude 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 CodeCLAUDE.md
CodexAGENTS.md 或自定义提示
Gemini.gemini/config.yaml

十、踩坑清单#

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

十一、几条实用经验#

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

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

MCP 入门到自建:协议原理 + MCPHub 管理 + 自己写一个
OAuth2 标准流程逐字段拆解:写注册机 / 接第三方登录必看
本博客所有文章除特别声明外,均遵循 CC BY-NC-SA 4.0 协议,转载请注明出处。
博客框架 Astro & Fuwari
一、三家的”性格”对比
二、安装
2.1 Claude Code
2.2 OpenAI Codex CLI
2.3 Google Gemini CLI
三、API 配置
3.1 用官方订阅(最省心)
3.2 用 API key(按量)
3.3 用第三方 API 网关(推荐)
四、Claude Code 关键功能
4.1 Subagents(子 Agent)
4.2 CLAUDE.md(项目记忆)
4.3 Plan Mode
4.4 Hooks
五、Codex CLI 关键功能
5.1 工作模式
5.2 模型选择
5.3 适合 Codex 的场景
六、Gemini CLI 关键功能
6.1 多模态输入
6.2 长上下文(200w token)
6.3 适合 Gemini 的场景
七、CLI 管理工具
7.1 CC Switch
7.2 ccNexus
7.3 Claude Code Hub
八、典型工作流:三个 CLI 配合用
九、共通技巧
9.1 指定 working directory
9.2 用 git 做安全网
9.3 让 AI 跑测试 = 双保险
9.4 上下文复用
十、踩坑清单
十一、几条实用经验