一文讲清 AI Coding 工具使用(新人友好版)

本文面向刚接触 AI 编程工具的开发者，系统梳理 Claude Code、Codex 的产品形态、使用方式、配置管理，以及如何在各类 IDE 中落地使用。

先搞清楚：AI Coding 工具的两大阵营
Claude 全产品线梳理
Codex 全产品线梳理
CLI 是什么？为什么重要？
在 IDE 中使用：VSCode 系、JetBrains、Trae
配置管理：CC Switch 是什么？怎么用？
供应商是什么？官方 vs 第三方中转
聊天记录存在哪？
从零开始的选择路径
常见问题 Q&A

一、先搞清楚：AI Coding 工具的两大阵营

目前主流的 AI Coding 工具来自两家：

阵营	产品	背后模型
Anthropic	Claude Code	Claude（Sonnet、Opus、Haiku）
OpenAI	Codex	GPT 系列

两者定位类似：让 AI 直接读取你的代码仓库，理解上下文，帮你写代码、改 Bug、跑命令。不是简单的代码补全，而是能自主操作文件、执行终端命令的「编程 Agent」。

除此之外还有 Gemini CLI（Google）、OpenCode 等工具，但目前生态最成熟、用户最多的还是 Claude Code 和 Codex。

二、Claude 全产品线梳理

2.1 Claude 桌面 App —— 一个 App，三个模式

Claude 桌面 App 是 Anthropic 的主力产品，包含三个模式，从侧边栏切换：

Claude 桌面 App
├── Chat     —— 对话模式，等同于 claude.ai，免费可用
├── Cowork   —— 自动化模式，处理本地文件、定时任务，需付费
└── Code     —— 编程模式，底层是 Claude Code 引擎，需付费

关键点：

桌面 App 本身免费下载，Chat 免费使用
Code 和 Cowork 需要 Pro、Max、Team 或 Enterprise 订阅
目前仅支持 macOS 和 Windows，Linux 用户只能用 CLI

2.2 Claude Code CLI —— 终端里的编程 Agent

这是通过 npm 安装的版本：

npm install -g @anthropic-ai/claude-code

CLI 版比桌面版多了什么：

支持第三方供应商（AWS Bedrock、Google Vertex AI 等）
支持多 Agent 编排（subagents）
完整的 CLI 参数控制（--model、--print 等）
Linux 可用

会话记录存储在：~/.claude/projects/（本地 JSONL 文件）

2.3 claude.ai/code —— Web 端监控面板

不是独立的编程工具，主要用于监控远程 Claude Code 会话的进度，手机上也能查看。

2.4 订阅计划与 Claude Code 的关系

计划	价格	Claude Code
Free	免费	✗ 不包含
Pro	$20/月	✅ 包含（有用量限制）
Max	$100/月起	✅ 包含（更高用量）
Team/Enterprise	按人收费	✅ 包含
API 按量计费	用多少付多少	✅ 可用

三、Codex 全产品线梳理

3.1 产品形态

Codex 的产品线比 Claude 更分散：

Codex 产品线
├── Codex Web     —— chatgpt.com/codex，云端，连接 GitHub 仓库
├── Codex 桌面 App —— 独立 GUI，`codex app` 启动
├── Codex CLI     —— 终端工具（就是我们 npm 安装的）
└── Codex IDE 插件 —— VS Code、Cursor、Windsurf 等

3.2 登录方式

Codex CLI 支持两种认证方式：

方式一：ChatGPT 账号登录（OAuth）

需要 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 订阅
订阅包含 Codex，不需要额外付费
登录时需要手机验证码，+86 中国大陆号码不支持

方式二：API Key 登录

去 platform.openai.com 申请
需要购买 Token（预充值）
支持所有国家，+86 可用

3.3 Codex Web 的特殊性

Codex Web 基于 GitHub 仓库运行，可以使用账户的免费额度，适合不想配本地环境的场景。

3.4 Codex CLI 的第三方供应商支持

Codex CLI 的配置文件在 ~/.codex/config.toml，支持：

本地模型（Ollama、LM Studio）：--oss 参数
Azure OpenAI
自定义 API 中转（国内中转服务商）

四、CLI 是什么？为什么重要？

4.1 CLI 的本质

CLI（Command Line Interface）就是在终端里运行的程序。Claude Code CLI 和 Codex CLI 都是这样的程序，通过 npm 全局安装：

npm install -g @anthropic-ai/claude-code   # Claude Code CLI
npm install -g @openai/codex               # Codex CLI

安装后，在任意目录输入 claude 或 codex 即可启动。

4.2 为什么 CLI 是核心？

关键认知：IDE 插件和桌面 App，底层都是调用 CLI。

VSCode 插件
Cursor 插件        ─────→  调用  ─────→  claude / codex CLI
JetBrains 插件
桌面 App（Code 模式）

这意味着：

CLI 的供应商配置对所有客户端生效
CLI 的版本决定了功能上限
会话记录统一存在本地 CLI 的目录里

4.3 CLI 的配置文件位置

~/.claude/
├── settings.json     # 全局配置（供应商、权限、MCP 等）
├── projects/         # 会话历史记录
└── ...

~/.codex/
├── config.toml       # 全局配置
└── ...

五、在 IDE 中使用：VSCode 系、JetBrains、Trae

5.1 VSCode 系（VSCode、Cursor、Windsurf）

安装插件：

在扩展市场搜索安装：

Claude Code：anthropic.claude-code（官方，2M+ 安装量）
Codex：OpenAI 官方插件

工作原理：

插件本质是在 IDE 内嵌入了一个面板，底层调用你本地安装的 CLI。配置共享 ~/.claude/settings.json。

插件能做但终端不方便做的事：

可视化 Diff 视图（逐行查看修改）
@ 提及文件（快速引用上下文）
内联代码建议面板
对话历史侧边栏

插件做不到但 CLI 能做的事：

完整 CLI 参数控制
多 Agent 编排
脚本集成和 CI/CD 流水线
无头模式（codex exec）

5.2 Cursor

Cursor 是基于 VSCode 内核的 AI IDE，原生集成了 AI 功能，同时支持安装 Claude Code 和 Codex 插件：

Cursor
├── 原生 AI 功能（Tab 补全、Composer）—— 使用 Cursor 自己的 API
├── Claude Code 插件                   —— 调用 Claude CLI
└── Codex 插件                         —— 调用 Codex CLI

可以同时安装，在不同场景下切换使用。

5.3 Trae

Trae 是字节跳动推出的 AI IDE，同样基于 VSCode 内核，支持安装 Claude Code 和 Codex 插件，使用方式与 VSCode 完全一致。

5.4 JetBrains（IntelliJ IDEA、GoLand 等）

JetBrains 系 IDE 支持 Claude Code GUI 插件，在插件市场搜索安装。

特点：

提供图形界面操作 Claude Code
底层同样调用本地 Claude CLI
共享 ~/.claude/settings.json 配置

Java 开发者注意： IDEA 中的 Claude Code 插件和终端里运行 claude 是同一套东西，供应商配置、会话记录完全共享。

六、配置管理：CC Switch 是什么？怎么用？

6.1 CC Switch 解决了什么问题

当你同时使用 Claude Code、Codex、Gemini CLI 等多个工具时，每个工具都有自己的配置文件格式：

Claude Code  →  ~/.claude/settings.json（JSON）
Codex        →  ~/.codex/config.toml（TOML）
Gemini CLI   →  各自的配置文件

切换 API 供应商（比如从官方 API 切到第三方中转）需要手动编辑这些文件，容易出错。

CC Switch 是一个桌面 GUI App，提供可视化界面，一键切换所有工具的供应商配置。

6.2 CC Switch 主要功能

一键切换供应商 —— 内置 50+ 供应商预设，不用手动改配置文件
统一 MCP 管理 —— 一个面板管理 Claude Code、Codex 等所有工具的 MCP 服务器
内置本地代理 —— 支持热切换、自动故障转移
会话历史浏览 —— 读取 ~/.claude/projects/ 等目录，可视化展示历史记录
技能/Prompt 管理 —— 统一管理 CLAUDE.md、AGENTS.md 等 Agent 配置文件

6.3 CC Switch 的工作原理

CC Switch 做的事情本质上是：修改 CLI 工具的配置文件。

CC Switch
    ↓ 修改
~/.claude/settings.json
~/.codex/config.toml
    ↓ 生效
Claude Code CLI / Codex CLI
    ↓ 被调用
VSCode 插件 / JetBrains 插件 / 桌面 App

所以 CC Switch 改了供应商，所有使用该 CLI 的客户端都会生效。

6.4 插件内选模型 vs CC Switch 配置供应商，会冲突吗？

不冲突，两者管的是不同层面：

CC Switch 管的是「去哪里」：用哪个供应商的 API、Base URL 是什么、用什么 Key
插件内选模型管的是「用什么」：用 Sonnet 还是 Opus，当前会话有效，不写入配置文件

唯一冲突场景： 如果你在 VSCode 的 settings.json 里单独配了 ANTHROPIC_BASE_URL 等环境变量，会覆盖 CC Switch 的配置。

解决方案： 供应商配置统一交给 CC Switch，不在 IDE 里重复配环境变量。

6.5 安装 CC Switch

# macOS（Homebrew）
brew tap farion1231/ccswitch
brew install --cask cc-switch

# 或直接从 GitHub Releases 下载 dmg

七、供应商是什么？官方 vs 第三方中转

7.1 什么是供应商

供应商（Provider）就是 API 请求发到哪里。

你的 Claude Code CLI
    ↓ 发送请求
[供应商]
    ↓ 转发或直接响应
Claude 模型（Anthropic 服务器）

7.2 官方供应商

工具	官方供应商	认证方式
Claude Code	api.anthropic.com	OAuth 登录或 API Key
Codex	api.openai.com	ChatGPT 账号或 API Key

7.3 第三方中转

第三方中转是指由国内或其他服务商搭建的代理服务，你的请求发到他们的服务器，再转发给官方 API。

优点：

解决国内网络访问问题
部分服务商提供折扣价格
支持多模型聚合

缺点：

数据经过第三方，有隐私风险
服务稳定性依赖服务商
需要审慎选择可信服务商

7.4 本地模型

Codex CLI 支持通过 --oss 参数连接本地运行的模型（Ollama、LM Studio），完全离线，数据不出本机。

八、聊天记录存在哪？

所有会话记录都保存在本地，不会上传到任何地方（代码内容除外，代码内容会发给 API 供应商处理）。

Claude Code 会话记录：
~/.claude/projects/<项目路径哈希>/
    └── *.jsonl     # JSONL 格式，每行一个事件

Codex 会话记录：
~/.codex/
    └── ...

CC Switch 的「会话历史」功能就是读取这些本地文件，做了一个可视化界面，没有额外存储。

查看你的 Claude Code 历史记录目录：

ls ~/.claude/projects/

九、从零开始的选择路径

9.1 我只是想试试，不想折腾

→ 用 Claude 桌面 App 的 Code 模式（需 Pro 订阅）

下载 App，订阅 Pro，点 Code 标签，直接开始。零配置，开箱即用。

9.2 我想在终端用，或者用 IDE 插件

第一步：安装 CLI

npm install -g @anthropic-ai/claude-code   # Claude Code
npm install -g @openai/codex               # Codex（可选）

第二步：认证

claude   # 首次运行会弹出认证流程
codex    # 同上

第三步：安装 IDE 插件（可选）

去 VSCode / Cursor / IDEA 的插件市场搜索安装对应插件。

第四步：安装 CC Switch（可选，同时用多工具时推荐）

统一管理供应商配置，避免手动改配置文件。

9.3 我想用第三方中转节省成本

选择一家可信的中转服务商，获取 API Key 和 Base URL
打开 CC Switch，添加自定义供应商，填入 Base URL 和 Key
一键切换，所有 CLI 工具和 IDE 插件同时生效

十、常见问题 Q&A

Q：Claude Code 插件和直接在终端跑 claude 有什么区别？

A：底层是同一个 CLI，区别在于界面。插件提供可视化 Diff、文件引用、对话面板等 GUI 功能，终端则有完整的参数控制权和脚本集成能力。两者配置共享，历史记录共享。

Q：CC Switch 改了供应商，IDE 插件会跟着变吗？

A：会。CC Switch 修改的是 ~/.claude/settings.json，这个文件被 CLI 和所有 IDE 插件共享。唯一例外是你在 IDE 的 settings.json 里单独配了环境变量，那个优先级更高。

Q：Cursor 自带的 AI 和 Claude Code 插件是一回事吗？

A：不是。Cursor 自带的 AI 功能（Tab 补全、Composer）调用的是 Cursor 自己的 API，使用 Cursor 的订阅额度。Claude Code 插件调用的是你本地安装的 claude CLI，使用你的 Anthropic 账号额度。两者独立，互不干扰。

Q：我的聊天记录会被 Anthropic 看到吗？

A：会话记录文件本身存在本地，Anthropic 看不到。但你发给 API 的代码内容，会经过 Anthropic 的服务器处理。Anthropic 官方声明不会用这些数据训练模型（默认设置下），具体见其隐私政策。

Q：用第三方中转安全吗？

A：存在隐私风险。你的代码内容会经过第三方服务器。如果是个人项目或学习代码问题不大，但如果涉及公司代码、敏感业务逻辑，建议使用官方 API 或完全本地的模型（Ollama）。

Q：JetBrains IDEA 里的 Claude Code 和终端里的是同一个？

A：是的。IDEA 插件只是一个 GUI 面板，底层调用你本地安装的 claude CLI，配置文件、会话记录完全共享。在 IDEA 里开的会话，在终端用 claude 也能续上。

Q：Codex 的 +86 手机号登不上去怎么办？

A：两个方案：一是用 API Key 方式登录（去 platform.openai.com 充值购买）；二是用第三方中转服务，不需要 OpenAI 账号，直接填 API Key 和 Base URL 即可。

附：工具关系总览图

                    你的代码仓库
                         │
          ┌──────────────┼──────────────┐
          │              │              │
    终端 claude      IDE 插件        桌面 App
    终端 codex    (VSCode/Cursor    (Chat/Code
                  /IDEA/Trae)        模式)
          │              │              │
          └──────────────┼──────────────┘
                         │
                    本地 CLI 层
              (~/.claude/settings.json)
              (~/.codex/config.toml)
                         │
                    CC Switch 管理
                         │
              ┌──────────┴──────────┐
              │                     │
          官方 API              第三方中转
       (api.anthropic.com)    (各中转服务商)
              │                     │
              └──────────┬──────────┘
                         │
                   Claude 模型

整理于 2026 年 5 月。AI 工具迭代极快，具体功能以官方最新文档为准。