AI 工具安装与入门指南

最近帮身边同事安装 AI 工具时，我发现大家最容易卡在两个地方。

第一个是经常被一堆名字绕晕： VS Code 、 CC Switch 、 Claude Code 、 Codex ，搞不清楚它们各自做什么，有什么用。
第二个是安装本身。尤其在现在的国内环境下，想快速把这些工具装好、配好，并没有想象中那么顺。网络环境、账号申请、模型配置，任何一个环节都可能让人卡半天。

所以在讲安装之前，我想先把这些工具的关系讲清楚。

第一部分：先讲清楚这些工具的关系

1. 大模型 Model ：负责思考

这是整个 AI 世界的核心，也是大家最熟悉的一层。平时大家使用 ChatGPT 、 Claude 、 Gemini 、豆包、 DeepSeek 等聊天工具，本质上都是在和大模型对话。可以把大模型理解成 AI 的“大脑”，负责理解问题、推理分析，并生成答案。

例如：

•GPT 系列

•Claude Opus / Sonnet

•Gemini

•DeepSeek

•GLM

•Qwen

这些都属于大模型这一层。但要注意一点：大模型本身主要负责“思考”和“生成”，它并不会天然帮你修改代码、操作电脑或者完成一整套任务。也就是说，它能给出答案，但不一定能把答案真正落到你的项目里。

2. Router 路由层：负责连接

随着 GPT 、 Claude 、 DeepSeek 、 Gemini 等模型越来越多，一个新的问题出现了：【这次到底应该调用哪个模型】？于是就有了 Router ，也就是模型路由和配置管理工具。Router 本身不会回答问题，也不会思考。它主要负责：

•管理多个模型；

•切换不同 Provider ；

•配置 API ；

•统一调用入口。

例如：

•CC Switch

•LiteLLM

•OpenRouter

都属于这一层。

可以把它理解成 AI 世界里的“调度中心”。它决定这一次让谁来思考。

为什么国内很多人会用 CC Switch ？

主要有三个原因。

第一，官方服务访问有门槛。

比如 Anthropic 官方 API 、 OpenAI 官方 API ，对于很多国内开发者来说，账号申请、支付方式、网络访问都可能带来额外成本。

第二，多模型切换很麻烦。

今天想用 Claude ，明天想试 DeepSeek ，后天又想切到 GPT 。如果每次都手动改环境变量、改配置文件，很容易把自己绕进去。

第三，配置集中管理更方便。

CC Switch 这类工具的价值，就是把多个模型服务统一放在一个入口里。你只需要在里面配置 API Key 、 Base URL 和模型信息，后面切换起来会轻很多。

所以它不是模型，也不是 Agent 。它更像是连接模型服务和本地工具之间的“开关面板”。

3. Agent 智能体：负责执行

以前的大模型更多是聊天。

你说：“帮我写一个 Python 脚本。”

模型返回一段代码。

然后就结束了。

但 Claude Code 、 Codex 这类 Agent 出现以后， AI 不只是回答问题了。它开始可以：

•阅读整个项目；

•制定执行计划；

•修改多个文件；

•运行终端命令；

•调用 Git ；

•自动完成任务。

所以 Agent 更像一个真正会工作的 AI 助手。

它负责把模型思考出来的结果真正执行出来。

这里有个常见误区：很多人会把 Claude Code 和 Claude 模型混在一起。

更准确的说法是： Claude Code 本质上是一个 Agent 工具，它默认使用 Anthropic 的 Claude 系列模型，比如 Opus 、 Sonnet 。但在一些配置场景下，也可以通过 CC Switch 等路由工具，切换到 GPT 、 GLM 、 DeepSeek 等其他模型。

也就是说：Claude Code 是让模型真正去读项目、改文件、跑命令的工具。

4. IDE 编辑器：负责展示和协作

很多人第一次接触 Claude Code 时都会有一个疑问：

为什么安装了 Claude Code ，还要安装 VS Code ？

因为 Claude Code 是干活的人， VS Code 是工作的地方。

IDE 本身并不会思考，也不会替你自动完成任务。它主要负责：

•查看代码；

•编辑代码；

•调试程序；

•管理 Git ；

•展示 Agent 的修改结果。

所以 IDE 更像你和 AI 一起工作的工作台。

最后再把这几层关系合起来看：

•大模型 Model ：负责思考，决定“怎么解决问题”；

•Router 路由层：负责连接，决定“找谁来思考”；

•Agent 智能体：负责执行，把方案真正落地；

•IDE 编辑器：负责展示，让你查看、管理和协作。

它们并不是竞争关系，而是像流水线一样层层协作。

第二部分：再安装这些工具

下面开始进入安装部分。

我会先讲 Codex ，再讲 Claude Code 、 CC Switch 和 VS Code 。顺序上我建议新手先从 Codex 这类更容易上手的工具开始，再逐步理解 Claude Code 和路由配置。

1. 安装和使用 Codex

Codex 是什么？

Codex 是 OpenAI 推出的 AI Coding Agent ，也就是 AI 编程智能体。它和大家熟悉的 ChatGPT 属于同一家公司的产品。

如果说 ChatGPT 是一个会聊天的大模型产品，那么 Codex 更像是一位能够帮你完成开发任务的 AI 工程师。

它不仅能够理解需求、生成代码，还可以阅读整个项目、修改文件、执行命令、调用 Git ，真正帮助开发者完成开发任务。

目前 Codex 提供多个使用入口，主要包括：

•桌面版 Desktop ：推荐新手使用，界面友好，上手简单。桌面版通常不需要额外配置编辑器和路由工具。

•终端版 CLI ：适合开发者在 Terminal 中使用，效率更高，也更容易融入日常开发流程。

大多数开发者使用 Codex CLI 时，会搭配 VS Code 等编辑器。编辑器负责代码浏览、编辑和调试， Codex 负责理解需求并执行任务。

和 Claude Code 不同的是， Codex CLI 默认支持直接使用 ChatGPT 账号登录。普通用户通常不需要额外配置 API Key 或 CC Switch ；只有在企业部署、 API 调用等场景下，才需要再考虑 API 配置。

下载与安装

可以通过 OpenAI 官方网站进入 Codex 下载页面，根据自己的操作系统下载对应版本。

官方下载地址：

https://chatgpt.com/zh-Hans-CN/codex/?openaicom_referred=true

安装完成后，使用自己的 ChatGPT 账号登录即可开始使用。

使用前需要准备

使用 Codex 前，需要提前准备两件事。

第一：一个 ChatGPT 账号。

目前支持多种注册方式，例如：

•Google 账号；

•Apple ID ；

•邮箱注册。

第二，能够正常访问 OpenAI 服务的网络环境。

由于 OpenAI 服务暂未面向中国大陆直接提供服务，因此需要提前准备好可用的网络环境。如果注册过程中需要手机号验证，也需要准备支持接收验证码的手机号。具体要求可能会根据 OpenAI 政策调整，以官方页面为准。

费用说明

相比 Claude Code ， Codex 在价格和使用门槛方面对个人用户更友好一些。

常见套餐包括：

•Free ：可体验基础功能，适合初次使用；

•Plus （20 美元/月）：适合大多数个人开发者；

•Pro （100/200 美元/月）：提供更高使用额度，更适合重度用户或专业团队。

如果使用过程中额度不足，可以升级到更高等级的订阅，以获得更多 Agent 使用次数和更高资源配额。

2. 安装和使用 Claude Code

Claude Code 是什么？

Claude Code 是 Anthropic 推出的 AI Coding Agent ，也是目前很受开发者欢迎的 AI 编程工具之一。

目前 Claude Code 提供 Desktop 桌面版和 CLI 终端版两种使用方式。其中， CLI 仍然是开发者最常见的使用方式，因此通常需要在 Terminal 中安装和运行。

为了获得更好的开发体验，大多数开发者还会搭配 VS Code 、 Cursor 等编辑器一起使用。编辑器负责代码浏览、编辑和调试， Claude Code 负责理解需求并执行任务。

对于国内开发者来说，由于 Anthropic 官方服务的使用存在一定门槛，因此很多人会采用 API 的方式接入 Claude Code 。同时，为了统一管理 API Key 、灵活切换不同的大模型，也会搭配 CC Switch 等模型管理工具一起使用。

第一步：安装 Node.js

由于 Claude Code 基于 Node.js 开发，因此需要先安装 Node.js 。

打开终端，检查是否已经安装：

node-vnpm-v

如果没有安装，可以前往 Node.js 官网下载 LTS 长期支持版。

官方下载：

https://nodejs.org/en/download

国内下载：

https://npmmirror.com/mirrors/node/

进入页面后，选择 LTS 版本下载并安装。

安装完成后，再次在终端输入：

node-vnpm-v

如果能正常返回版本号，说明 Node.js 和 npm 已经安装成功。

第二步：安装 Claude Code

完成 Node.js 安装后，打开 Terminal 终端，执行以下命令安装 Claude Code 。

方式一，官方安装脚本：

curl-fsSLhttps://claude.ai/install.sh|bash

方式二，使用 npm 安装：

npminstall-g@anthropic-ai/claude-code

安装完成后，可以执行以下命令检查是否安装成功：

claude--versionclaudedoctor

如果能够正常返回 Claude Code 的版本信息，并且 claude doctor环境检测通过，则说明 Claude Code 已经安装成功。

第三步：下载和配置 CC Switch

CC Switch 的下载地址：

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

安装完成后，还需要准备可用的 API 服务，也就是官方 API 或第三方 API 服务平台，并获取对应的 API Key 。

打开 CC Switch 后，可以按照下面的步骤完成配置：

1.点击右上角“+”，新增一个 Provider ；

2.选择需要接入的模型服务，例如 Anthropic 、 OpenAI 、 DeepSeek ，或其他兼容 OpenAI API 的平台；

3.填写对应的 API Key ；

4.如果使用第三方 API 服务平台，还需要填写对应的 Base URL ；

5.保存配置，并确保顶部开关处于 ON 状态。

配置完成后， CC Switch 会自动管理 Claude Code 所需的 API 配置。

当你在终端执行：

claude

Claude Code 就会通过 CC Switch 调用你配置好的模型服务，不需要每次手动修改环境变量或 API 配置。

如果后续想切换到 Claude 、 GPT 、 DeepSeek 、 GLM 等不同模型，只需要在 CC Switch 中新增或切换对应的 Provider 即可，不需要重新安装 Claude Code 。

第四步：下载 VS Code

VS Code 官方下载地址：

https://code.visualstudio.com/download

VS Code 的作用不是替代 Claude Code ，而是提供一个更适合看代码、改代码、管理项目的工作台。

你可以把项目用 VS Code 打开，再让 Claude Code 或 Codex 在终端里处理任务。这样 AI 改了哪些文件、代码发生了什么变化，你都能在编辑器里看得更清楚。

最后小结

如果你刚开始接触 AI Coding 工具，不建议一上来就把所有东西都装一遍。

更推荐的顺序是：

1.先搞清楚大模型、 Router 、 Agent 、 IDE 之间的关系；

2.再从 Codex 这类更容易上手的工具开始；

3.如果你经常写代码，再继续配置 Claude Code ；

工具不是越多越好，真正重要的是：你知道每个工具负责哪一层，以及什么时候该打开它。

由于公众号篇幅有限，很多内容无法一一展开。我整理了一份《AI Coding 国内完整实践手册》，涵盖环境搭建、账号开通、Claude Code、Codex、CC Switch、API 配置、常见问题排查等完整内容，帮助大家从零搭建自己的 AI Coding 环境。

如果感兴趣，欢迎后台回复「AI教程」或私信我。