AI 编程 Agent 从零安装与配置：Claude Code、Codex、Cursor 手把手教程

你大概率已经听说了——AI 编程工具在 2026 年不再是玩具，而是每天都在帮开发者写代码、修 bug、跑测试的真实生产力。但"听说好用"和"自己跑起来"之间，隔着一道大多数评测文章不讲的鸿沟：怎么装、怎么注册、怎么付费、怎么在国内网络环境下用上合适的模型。

这篇文章不讲"哪个更好"（那是评测的事），只讲"怎么跑起来"。每一步都有可复制粘贴的命令，每一个配置项都解释它为什么存在。读完你应该能在 30 分钟内把三款主流 Agent 全部装好、配好模型、开始写代码。

一、Claude Code：从安装到切换国产模型

Claude Code 是 Anthropic 出品的终端原生编程 Agent，目前 SWE-bench Verified 得分最高的选手（Claude Opus 4.8 下达到 88.6%）。它没有图形界面，所有操作在终端里完成——这恰好也是它最灵活的地方。

1.1 安装

前置条件：Node.js 18 或更高版本。先确认一下：

node --version   # 应该 >= v18.0.0

如果版本不够，去 nodejs.org 下载 LTS 版安装。然后全局安装 Claude Code：

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

等待安装完成后验证：

claude --version

屏幕上打印出版本号就说明安装成功了。如果提示 command not found，检查一下 npm 的全局 bin 目录是否在 PATH 中——Windows 用户用 npm prefix -g 找到目录，macOS/Linux 通常是 /usr/local/bin。

1.2 认证

Claude Code 支持两种认证方式，推荐第一种：

方式一：OAuth 浏览器登录（推荐）

直接在终端里输入 claude 回车，首次运行会自动打开浏览器跳转到 Anthropic 的登录页。在浏览器里登录你的 Anthropic 账号，授权后终端会自动获取 token。这种方式的好处是 token 管理全自动，过期刷新不用手动干预。

方式二：API Key

如果你更习惯直接管理 API Key，或者在没有浏览器的远程服务器上操作：

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

API Key 在 console.anthropic.com 的 API Keys 页面创建。注意：使用 API Key 计费走 API 费率（按 token 计费），不是订阅费率。

1.3 注册与付费

Anthropic 的付费体系分两条线：

类型	费用	适合
免费额度	$5（新用户一次性）	试水，评估是否适合自己
Claude Pro 订阅	$20/月	日常开发，额度通常够用
Claude Max 5x	$100/月	重度使用，全天候编码
Claude Max 20x	$200/月	极限用量，含最大上下文窗口
API 按量	输入 $3/百万 token，输出 $15/百万 token（Opus 4.8）	嵌入 CI/CD 管道或自己控制用量

注册地址：console.anthropic.com。新用户有 $5 免费额度，足够跑几十次中等复杂度的任务。个人开发者从 Pro $20/月起步是最稳妥的选择——额度内用完不额外收费，日均成本不到 7 毛钱。

1.4 手动切换模型

Claude Code 默认使用 Claude Opus 和 Sonnet 系列模型。如果你想接国产模型来降低成本或满足数据合规需求，有两种方式：

临时切换（/model 命令）

在 Claude Code 会话中输入 /model，会弹出交互式菜单让你选择当前会话使用的模型。这个切换只对当前会话有效，重启后恢复默认。

永久切换（环境变量）

Claude Code 支持 Anthropic Messages API 兼容端点——也就是说，任何实现了 /v1/messages 接口的模型服务都可以接入。目前国内已有三家厂商提供原生兼容：

厂商	ANTHROPIC_BASE_URL	主力模型	API Key 申请地址
DeepSeek	`https://api.deepseek.com/anthropic`	deepseek-v4-pro	platform.deepseek.com/api_keys
智谱 GLM	`https://open.bigmodel.cn/api/anthropic`	GLM-4.5	bigmodel.cn
月之暗面 Kimi	`https://api.moonshot.cn/anthropic`	kimi-k2.5	platform.kimi.com

以 DeepSeek 为例，完整配置如下：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_API_KEY=sk-xxxxxxxx   # 你的 DeepSeek API Key
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

这里有几个关键细节：DeepSeek 必须显式设置 ANTHROPIC_MODEL 和子代理模型，因为默认的 Claude 模型名（claude-opus-4-8 这类）DeepSeek API 不认识。子代理用 Flash 版本是因为子代理通常做简单任务（读文件、搜索），不需要最强模型，用便宜的能省大量 token。

切换到 Kimi 时配置类似，把 URL 和模型名替换即可。智谱的配置最简单，只需两个变量：

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=xxxxxxxx   # 智谱 API Key

切换代价要心里有数：使用第三方模型时，工具调用质量会下降（Agent 调用外部命令、读写文件的准确率降低）、扩展思考（/think）不可用、提示缓存不可用。简单说——Agent 的工程框架还是同一个高质量框架，但每一步的代码理解和生成换了更便宜的引擎。日常编码够用，复杂重构建议切回原生 Claude。

二、OpenAI Codex：CLI + 桌面客户端双模式

Codex 是 OpenAI 推出的编程 Agent，和 Claude Code 从同一思路出发（终端原生的自主编程助手），但多了一个选择：除了 CLI，还有全功能桌面客户端。

2.1 CLI 安装

前置条件和 Claude Code 一样——Node.js 18+。安装命令：

npm install -g @openai/codex

验证安装：

codex --version   # 当前最新约 0.145.x

Windows 用户也可以直接用 PowerShell 一键安装：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

如果是 Windows 原生环境（非 WSL），官方推荐优先使用桌面客户端，CLI 在非 WSL 的 Windows 下可能有路径和权限问题。macOS 和 Linux 用户 CLI 和桌面端都可正常使用。

2.2 桌面客户端安装

Codex 桌面客户端是三面板布局——左侧导航栏（项目、对话、插件、自动化）、中间对话区、右侧结果查看区（diff 对比、内置终端、文件预览）。核心功能包括：

并行代理：同时跑多个 Codex 线程，每个线程独立工作目录
可视化 Diff：改了什么代码一目了然，可逐行接受或拒绝
Worktree 隔离：每次修改在独立的 Git worktree 中进行，不会弄脏工作区
自动化：把常用命令保存为一键按钮，或设置定时任务
Computer Use：直接操控桌面应用（macOS 和 Windows 均支持）

安装方式：

平台	方式
Windows	Microsoft Store 搜索 "Codex"，或 `winget install Codex -s msstore`
macOS	官网 chatgpt.com/codex 下载 .dmg

装好后登录 ChatGPT 账号即可使用。CLI 用户也可以通过 codex app 命令直接启动桌面端。

2.3 认证与付费

Codex 的付费和 ChatGPT 账号绑定：

类型	费用	包含什么
ChatGPT 免费版	免费	基础 Codex 功能，有限额度
ChatGPT Plus	$20/月	完整 Codex 功能，充足额度
ChatGPT Pro	$200/月	含 Cloud 沙盒（远程执行环境）
API 按量	GPT-5-Codex: 输入 $1.25/百万 token，输出 $10/百万 token	适用于 CI 管道或自建工具

认证方式：

桌面客户端：直接登录 ChatGPT 账号（推荐，功能最全）
CLI：设置环境变量 OPENAI_API_KEY=sk-xxxxxxxx（API Key 方式登录，部分功能受限，不支持 Worktree 和 Computer Use）

API Key 在 platform.openai.com/api-keys 创建。

2.4 配置与模型选择

Codex 的配置文件在 ~/.codex/config.toml，登录后自动生成。模型选择有两种途径：

桌面客户端：输入框旁边的下拉菜单直接选——可选 GPT-5-Codex 系列，也能切到 GPT-5.1 或 o4-mini
CLI：启动时用 codex --model gpt-5-codex 参数指定模型

Codex 默认绑定 OpenAI 系列模型，没有官方支持切换到第三方模型的机制（不像 Claude Code 可以改 BASE_URL）。如果你的环境不方便访问 OpenAI API，要么用桌面客户端走 ChatGPT 通道，要么在后续第四节的 CC Switch 中配置代理。

三、Cursor：图形化 IDE 的最短上手路径

Cursor 是基于 VS Code 分支的 AI 原生 IDE，也是目前社区最大的 AI 编程工具。和前面两款的区别在于：它不是一个外挂到终端的 Agent，而是一个换掉了整个编辑器的 AI 编程环境。

3.1 安装

去 cursor.com 下载对应平台的安装包，双击安装。Windows、macOS、Linux 全支持。安装后首次启动会有引导流程——选择主题、快捷键风格（VS Code / Vim / 等）、是否从 VS Code 导入设置。

3.2 注册与付费

Cursor 支持邮箱、GitHub、Google 三种注册方式。付费层级：

层级	费用	额度
Hobby（免费）	免费	2000 次代码补全/月，有限的高级模型调用
Pro	$20/月	约 200-300 次高级模型调用，溢出按 API 费率计费
Pro+	$60/月	更大的高级模型额度
Business	$40/人/月	团队管理、集中计费

从 Hobby 免费版开始试用是最合理的。2000 次补全在日常开发中大约能用一周，够你判断适不适合自己。

3.3 模型切换

Cursor 的模型切换是所有工具里最直观的——因为它有一个漂亮的下拉菜单。操作路径：

打开 Cursor，进入任意项目
右侧面板或底部状态栏找到模型选择器
下拉菜单里直接切：Claude Opus / Sonnet、GPT-5.1 / GPT-5-Codex、Gemini 3 Pro、DeepSeek V4

也支持 BYO-Key（自带 API Key）：Settings > Models > 填入你自有账号的 API Key，就能用你自己的额度和费率。这是 Cursor 的一大优势——你可以用 Claude 的 API Key 在 Cursor 里调用 Claude，绕过 Cursor 自身的额度限制。

省钱技巧：日常补全用 Sonnet 或 DeepSeek Flash，遇到复杂重构任务才临时切到 Opus。这个习惯能让月账单从 $87 降到 $30 左右，功能体验几乎没有可感知的下降。

四、CC Switch：一键切换，告别手动配环境变量

前面三节你看到了一个共同的痛点：每换一个模型，就得手动改环境变量、编辑配置文件、记住了各家端点地址。如果你同时装了 Claude Code、Codex 和其他 Agent，这些配置散落在不同文件中，管理起来非常头疼。

CC Switch 就是解决这个问题的——一款免费、开源（GitHub: farion1231/cc-switch）、基于 Tauri 2 的跨平台桌面工具，统一管理 8 款 AI 编程 Agent 的模型和供应商配置。

4.1 安装

去官网 ccswitch.io 下载对应平台的安装包。Windows、macOS、Linux 全支持。也提供 Homebrew：

brew install ccswitch

源码和 release 在 github.com/farion1231/cc-switch。注意：CC Switch 完全免费，不要在任何要求付费的网站上下载。

4.2 导入供应商

打开 CC Switch，左侧是 Agent 列表（Claude Code、Codex、Gemini CLI、Grok Build 等），右侧是供应商管理面板。内置了 50+ 供应商预设——Anthropic 官方、OpenRouter、DeepSeek、AWS Bedrock、Google Vertex AI、智谱、Kimi 等都在列表中。

操作流程：

点左侧选中 Claude Code
在右侧供应商列表中找 DeepSeek，点"导入"
粘贴你的 DeepSeek API Key
点"启用"

四步完成，CC Switch 会自动写入对应的环境变量和配置文件。不用打开终端，不用手打 export。

4.3 一键切换模型

日常切换更简单：在 CC Switch 主界面选中 Claude Code，在启用的供应商列表中点一个——比如从 Anthropic 切到 DeepSeek——即时生效。系统托盘也支持右键快捷切换，不用打开主窗口。

如果你在测试不同模型的表现——对比 DeepSeek V4 和 Claude Opus 在同一段代码上的输出——这个切换流程几秒钟搞定，而不是每次手动改四个环境变量。

4.4 进阶功能

几个值得了解的额外能力：

本地代理与故障转移：CC Switch 可以启动一个本地代理，自动做格式转换（把 Anthropic 格式的请求翻译成 OpenAI 格式），附带熔断器和健康监控。某个供应商挂了自动切到备用——不用手动干预。
用量仪表盘：跨供应商统计 Token 用量、花费、请求次数，带趋势图。如果你同时用 Anthropic 和 DeepSeek，可以直观比较两者各花了多少钱。
云同步：通过 Dropbox、OneDrive、iCloud 或 WebDAV 在多台设备间同步配置。办公室电脑和家里笔记本用同一套配置。
MCP 和 Skills 管理：统一管理 Claude Code、Codex、Gemini CLI 的 MCP 服务器和 Skills 插件，支持双向同步。

4.5 CLI 配套工具

如果你没有 GUI 环境（比如 SSH 到远程服务器，或者在 Dev Container 里开发），CC Switch 生态有两个命令行工具：

ccsc（@terranc/ccsc）：环境隔离启动器。每个终端会话可以使用不同供应商，不修改全局配置。

# 在终端 A 用 DeepSeek
ccsc claude --provider deepseek
# 在终端 B 用 Anthropic 原生
ccsc claude --provider anthropic

两个终端互不干扰，各自独立配置。

ccswitch-tui：终端 TUI 界面，功能和桌面版一致，可以在远程服务器上用键盘完成供应商切换和配置管理。安装：

npm install -g ccswitch-tui

结尾

回顾一下从零到跑通的全过程：装好 Claude Code（npm 一行命令）、Codex（CLI + 桌面端双选）、Cursor（下载即用），注册账号了解付费结构，然后用 CC Switch 统一管理所有 Agent 的模型配置。再也不用记 DeepSeek 的端点地址是 api.deepseek.com/anthropic、智谱的是 open.bigmodel.cn/api/anthropic——这些都在 CC Switch 的预设列表里等着你点一下。

快速参考表：

Agent	安装命令	认证	模型切换
Claude Code	`npm install -g @anthropic-ai/claude-code`	OAuth / API Key	`/model` 命令 / 环境变量
Codex CLI	`npm install -g @openai/codex`	ChatGPT 账号 / API Key	`--model` 参数
Codex Desktop	Microsoft Store / 官网下载	ChatGPT 账号	下拉菜单
Cursor	cursor.com 下载	邮箱/GitHub/Google	设置 > Models 面板
CC Switch	ccswitch.io 下载	各供应商 API Key	一键点击

下一步建议：如果你的环境在国内，或者想省 API 费用，优先装 Claude Code + CC Switch 这个组合——Claude Code 的 Agent 工程目前最强，CC Switch 让你可以随时在 Claude 原生和 DeepSeek/智谱/Kimi 之间切换，兼顾能力和成本。然后装 Cursor 作为日常 IDE 补充。Codex 桌面客户端在需要可视化 diff 审查和并行任务时非常好用。三款各有擅场，配一套顺手的工作流比押注单一工具要灵活得多。

写于 2026 年 7 月 30 日