AI 辅助编程工具经历了三次代际跨越：从最早的代码补全（Autocomplete），到对话式助手（Chat Assistant），再到如今以 Claude Code 为代表的自主智能体（Agentic Coder）。
Claude Code是 Anthropic 推出的重量级终端智能体。它是一个能直接访问文件系统、运行终端命令、集成版本控制的完整工作流环境。
结合官方文档与最新的技术调研，本文将重点抓住四个关键模块：
- 深入理解
Claude Code的本质定义、三层核心架构和代理循环机制。 - 通过与
Cursor和 OpenAI Codex 的系统性横向对比，多个维度建立清晰的工具选型认知。 - 演示三大平台上的完整安装配置流程，确保能在自己的机器上顺利跑通。
- 通过分层验证手段确认部署结果的正确性，并提供常见问题的排查指南。
接下来我们会按照「认知 → 对比 → 实操 → 验证」的主线展开。
1. 什么是 Claude Code
很多人已经听说过它，甚至已经在使用，但对它的技术本质、底层架构和工作机制未必有系统的理解。
Claude Code 为什么能在 SWE-bench Verified 测试中达到 80.9% 的自主问题解决率，远超多数竞品？
Claude Code 是一个代理套件（Agentic Harness）——将 Claude 模型的推理能力封装在一个能够直接访问文件系统、运行终端命令并集成版本控制系统的执行环境中。
它的工作模式基于「代理循环（Agentic Loop）」，涵盖上下文采集、行动执行与结果验证三个交织的阶段。这种端到端的任务处理能力，使其在处理诸如「修复整个项目的 Lint 错误」或「为身份验证模块编写完整测试用例」等复杂任务时表现卓越。
1.1 产品定位与核心理念
官方文档原话
Claude Code是一个「可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成」的代理编码工具（Agentic Coding Tool）。它可以在终端（Terminal）、IDE（VS Code / JetBrains）、桌面应用和浏览器中使用。
Claude Code 坚持「终端优先」的 Unix 哲学。它认为终端是开发者的核心指挥部，通过 CLI 接入可以实现与编译、构建及测试工具链的零距离对接。
在终端中输入 claude 即可启动一个交互式会话，你用自然语言描述你想做的事情，Claude Code 会自主规划执行路径、读取相关文件、编写代码、运行测试、提交 Git 变更——整个过程就像你在和一个经验丰富的同事进行结对编程（Pair Programming）。
1.2 三层核心架构：模型、工具与环境的协同
Claude Code 的效能从何而来？答案在于其独特的三层协作架构。
模型层（The Brain）：
Claude Code 的「大脑」，基于Claude 3.5 Sonnet或Opus模型，引入了Extended Thinking（扩展思维）机制。它负责理解复杂意图、拆解长序列任务，并决定何时调用何种工具，是整个系统的“总指挥”。
工具层（The Hands）：
这是 Claude Code 的「双手」，为模型提供了一套标准化的操作接口。
环境层（The Field）：
智能体直接运行在开发者的本地工作目录中。它能够感知当前的 Git 状态、环境变量、项目配置文件以及通过 CLAUDE.md 文件传达的团队规范。
核心洞察： 正是「模型的推理能力 + 工具的执行能力 + 环境的感知能力」三者的紧密协同，使得
Claude Code能够完成从理解需求到验证交付的端到端闭环，而不仅仅是生成一段代码片段。
1.3 代理循环（Agentic Loop）
三层架构提供了「能力基座」，而让 Claude Code 真正高效运转的核心引擎，是其代理循环（Agentic Loop）机制。Claude Code 在接到任务后会进入一个自驱动的多轮循环，直到任务完成或需要人工决策时才停下来。
这个循环包含四个交织的阶段：
探索（Explore）：
智能体首先调用 ls、grep 等工具扫描项目结构，理解代码库的组织方式、技术栈和依赖关系。这一阶段的目标是建立「项目地图」，为后续的精准操作奠定基础。
规划（Plan）：
在充分探索的基础上，模型将复杂需求拆解为可执行的子任务（Subtasks）。对于大型任务，它会在 CLAUDE.md 或 SPEC.md 中记录执行计划，确保思路清晰、步骤有序。
实施（Implement）：
利用 MultiEdit 等工具同时修改多个相关文件。
例如，在修改 API 定义时，它会同步更新对应的 Mock 数据和测试用例，而不是只改一个文件留下一堆不一致。
验证（Verify）：
运行 Shell 指令（如 npm test、pytest、cargo build）查看构建是否通过。
如果失败，它会将 stdout/stderr 的报错信息输入回模型，自动开始第二轮循环——修改代码、重新测试——直到所有测试通过或达到重试上限。
正是这种「自我反馈」机制，使得 Claude Code 生成的代码 rework 率比竞品低约 30%。
1.4 核心功能矩阵
| 功能维度 | 具体应用场景示例 | 技术实现机制 |
|---|---|---|
| 代码生命周期自动化 | 修复 Bug、重构模块、编写单元测试 | 闭环代理循环 + 搜索与编辑工具链 |
| 版本控制集成 | 自动暂存更改、撰写提交消息、创建分支并提交 PR | 直接集成 Git 指令 |
| 复杂任务规划 | 基于 PRD 构建完整的 Spring Boot 应用 | 任务原语拆解 + 子代理调度 |
| 跨工具链集成 | 通过 MCP 协议读取 Jira、Slack 或 Google Drive 数据 | 模型上下文协议 (MCP) |
| 环境维护 | 解决合并冲突、更新依赖、修复 Lint 错误 | 全局文件检索 + 多文件编辑 |
| CI/CD 自动化 | GitHub Actions 代码审查、GitLab CI/CD 问题分类 | 管道式数据处理 + 非交互模式 |
| 多媒介输入 | 粘贴错误日志截图、设计稿图片作为任务上下文 | 多模态模型推理 |
1.5 关键特性与高级概念
CLAUDE.md（项目记忆）、MCP（工具互联）和权限分级模型（安全边界）这三项——它们分别解决了「AI 如何理解你的项目」「AI 如何触达你的工具链」和「AI 被赋予了多大的权力」这三个核心问题。
Claude Code 关键特性:
| 特性 | 说明 | 核心价值 |
|---|---|---|
CLAUDE.md | 项目根目录下的 Markdown 文件，每次会话自动加载 | 设定编码标准、架构决策、首选库，让 AI 遵循团队规范 |
MCP | 连接外部数据源的开放标准协议 | 让 Claude Code 访问 Google Drive、Jira、Slack、Figma 等外部系统 |
| Hooks | 在 Claude Code 操作前/后执行的 Shell 命令 | 文件编辑后自动格式化、提交前自动 Lint 检查 |
| Skills | 可打包共享的工作流模板 | 团队共享 /review-pr、/deploy-staging 等标准化流程 |
| Sub-agents | 生成多个 AI 代理并行工作 | 主代理协调分配，子代理通过 Git Worktrees 并行处理不同任务 |
| Plan Mode | 规划模式，AI 先设计方案再执行 | 复杂任务先规划、评审，获批后再实施（只读，不执行写操作） |
CLAUDE.md 是智能体在每个会话开始时强制阅读的「项目法典」。它应当包含构建/测试命令、代码风格约定以及架构决策。保持文件精简、及时清理过时规则，对于维持智能体的判断准确性至关重要。
1.6 安全与权限模型
Claude Code 在设计上采用了权限分级模型，确保开发者始终掌握控制权。
Claude Code 权限分级模型
| 权限模式 | 行为说明 | 适用场景 |
|---|---|---|
| default（标准模式） | 写文件、运行 Bash 命令前必须获得用户逐一批准 | 日常开发，安全性最高 |
| plan（计划模式） | 只读模式，仅分析代码，不执行任何写操作 | 代码审查、架构分析 |
| acceptEdits | 代码编辑自动批准，但 Bash 命令仍需人工审核 | 信任编辑但需控制命令执行 |
| 全自动模式 | 所有操作自动批准（需谨慎） | 受控的 CI/CD 环境 |
Claude Code 通过操作系统级别的沙箱机制保护用户隐私和系统安全：在 Linux 上使用 bubblewrap，在 macOS 上使用 seatbelt，来限制文件读取范围和网络访问。严禁在未沙箱化的环境下使用 --dangerously-skip-permissions 参数——这会完全绕过安全检查，仅适用于完全受控的自动化流水线。
在交互操作层面，两个快捷键值得记住：按 Esc 两次可以紧急停止操作并触发自动快照回滚（Checkpointing），按 Shift+Tab 可以在 Normal（询问模式）、Auto-Accept（自动模式）和 Plan（计划模式）之间循环切换。
1.7 运行环境与使用方式
提供了五种入口，适配不同开发者的偏好和工作场景：
终端 CLI:
最核心、功能最完整的使用方式。在终端中输入 claude 启动交互式会话，或使用 claude "task" 执行一次性任务。
VS Code / Cursor 扩展:
在编辑器中提供内联 Diff 视图、@-提及、计划审查等功能。安装方式是在扩展市场搜索 "Claude Code"。
JetBrains 插件:
支持 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains 全家桶，提供交互式 Diff 查看和选择上下文共享。
桌面应用:
独立应用程序，支持可视化 Diff 查看、多会话并行和云会话启动。支持 macOS 和 Windows。
Web 版:
在浏览器中运行，无需本地安装。适合启动长时间运行的任务或处理本地没有的仓库。访问 claude.ai/code 即可使用。
重要提示： 所有使用方式连接的是同一个底层
Claude Code引擎，你的CLAUDE.md文件、设置和MCP服务器配置在所有界面中通用。你甚至可以用/teleport命令将 Web 上的会话拉入终端，或用/desktop将终端会话交接给桌面应用——这种跨界面的流动性，是Claude Code生态的一大亮点。
2. Claude Code 与 Cursor、Codex 的区别与联系
2.1 架构与工作流差异
Claude Code（终端原生代理）
将AI作为终端里的“资深工程师”，赋予其直接操控本地环境与工具链的权限，在确保人工审批的前提下自主执行任务。
Cursor（IDE增强）
基于VS Code深度定制，将AI无缝融入图形化编辑界面，通过实时补全与内联交互，为开发者提供“无感”的智能辅助体验。
Codex（云端沙箱）
构建独立的云端隔离环境，让AI在沙箱内自主完成从代码修改到测试的全流程，最终以Pull Request形式交付成果，实现开发与本地环境的解耦。
2.2 核心效能与性能基准对比
| 评价维度 | Claude Code | Cursor (Pro) | OpenAI Codex (App) |
|---|---|---|---|
| 基础模型 | Claude Sonnet/Opus | 混合模型 (GPT-4o/Claude) | GPT-5.3 Codex (2026 版) |
| SWE-bench 评分 | 80.9% (业内领先) | 约 72.5% | 约 78.4% |
| Token 消耗效率 | 极高（比 Cursor 节省约 5.5x） | 较低（频繁全量上下文发送） | 中等（优化了缓存机制） |
| 代码 rework 率 | 低 30%（更具生产就绪性） | 标准 | 略低于标准 |
| 并发任务支持 | 子代理 + Git Worktrees | 有限（主要单线程交互） | 原生多代理并行 |
| 平台兼容性 | 全平台 (Win/Mac/Linux) | 全平台 | macOS 独占（首发阶段） |
| 典型月费 | 200 | $20/月 | 包含在 ChatGPT 订阅中 |
3. 多平台安装配置教程
无论你使用的是 Windows、Linux 还是 macOS，跟着步骤走完之后，你都能在终端中成功运行 claude 命令并启动交互式会话。
3.1 Windows 安装配置
步骤一：安装 Claude Code（PowerShell 原生安装）
在 Windows 上安装 Claude Code，官方最推荐的方式是 PowerShell 原生安装，支持自动更新，安装后 claude.exe 位于 %USERPROFILE%\\.local\\bin\\ 目录。
（1）以管理员身份打开 PowerShell
按 Win + S 搜索 "PowerShell"，在搜索结果中右键点击 "Windows PowerShell"，选择 "以管理员身份运行"
在打开的管理员 PowerShell 窗口中，先确认 Git 是否已安装（Claude Code 需要 Git Bash 作为执行环境）：
git --version
如果输出了版本号（如 git version 2.x.x）说明 Git 已就绪，直接进入下一步。
如果报错"命令不存在"，需要先安装 Git for Windows：
-
- 访问 git-scm.com/downloads/w… 下载 Windows 版 Git
-
- 安装时勾选 "Git Bash Here" 和 "Add to PATH" 选项
-
- 安装完成后，重新打开 PowerShell 并再次运行
git --version验证
- 安装完成后，重新打开 PowerShell 并再次运行
（2）执行 Claude Code 安装命令
Git 确认安装完毕后，在管理员 PowerShell 中输入以下命令并回车：
# 安装最新版本（默认）
irm https://claude.ai/install.ps1 | iex
# 安装稳定版本（推荐生产环境使用）
# & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
# 安装指定版本号
# & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
（3）安装结果说明
安装命令执行完成后，终端将显示如下输出：
输出中的关键信息：
√ Claude Code successfully installed! — 安装成功确认``
Version: 2.1.50 — 已安装的版本号
Location: C:\Users\DELL\.local\bin\`claude.exe` — 可执行文件位置
（4）手动添加环境变量
安装脚本不会自动将 claude.exe 所在目录添加到系统 PATH，需要手动完成。
操作路径为： 按 Win + S 搜索 "环境变量" → 打开 "编辑账户的环境变量" → 在上方 "用户变量" 区域选中 Path → 点击 "编辑" → 点击 "新建" → 粘贴路径 C:\Users\DELL.local\bin（将 DELL 替换为你的实际用户名）→ 逐层点击 "确定" 保存。
完成后务必关闭当前所有 PowerShell 或终端窗口，重新打开一个新的 PowerShell。 环境变量修改只对新打开的终端生效，不重启终端将无法识别 claude 命令。
（5）验证安装是否成功
重新打开 PowerShell 后，运行以下命令验证：
claude --version
如果能看到版本号（如 2.1.86），就说明一切搞定了！
如果仍提示"claude 不是内部或外部命令"，请检查：
- PATH 是否添加到了 "用户变量" 中的 Path（不是系统变量）
- 是否已完全关闭旧 PowerShell 并重新打开了新窗口
（6）配置 Git Bash 路径（仅在报错时需要）
如果运行 claude 时出现 "requires git-bash" 错误，说明 Claude Code 找不到 Git Bash，需要手动指定路径：
# 临时设置（仅当前会话有效）
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
# 永久设置（通过系统属性 → 环境变量添加）
# 变量名: CLAUDE_CODE_GIT_BASH_PATH
# 变量值: C:\Program Files\Git\bin\bash.exe
步骤二：首次启动
安装并配置好 PATH 之后，进入项目目录启动 Claude Code，完成账号绑定。
（1）进入项目目录，启动 Claude Code
在 PowerShell 中切换到你的工作目录，然后输入 claude 启动：
cd D:\你的项目文件夹
claude
首次启动时，Claude Code 会弹出工作区安全检查，询问是否信任当前目录：
选择 "1. Yes, I trust this folder" 并按 Enter，进入 Claude Code 主界面：
设置完成后，如果出现 Claude Code on Windows requires git-bash 错误，请检查环境变量 CLAUDE_CODE_GIT_BASH_PATH 是否指向了正确的 bash.exe 路径。
3.2 Linux 安装配置
相比 Windows，Linux 的安装流程要简洁得多——毕竟 Claude Code 的底层就是为类 Unix 环境设计的，Linux 是它的「原生生态」。
（1）确认系统环境
在安装之前，我们需要确认系统版本和基本工具是否满足要求。Claude Code 要求 Ubuntu 20.04+ 或 Debian 10+。
# 查看系统版本
cat /etc/os-release
# 确认 curl 已安装（安装脚本需要）
curl --version
# 如果 curl 未安装，通过包管理器安装
sudo apt update && sudo apt install -y curl # Ubuntu/Debian
sudo yum install -y curl # CentOS/RHEL
（2）执行原生安装脚本
Linux 上的安装只需要一行命令。安装脚本会自动检测你的系统架构（x86_64 / ARM64），下载对应的二进制文件，并放置在 ~/.local/bin/ 目录下。
# 安装最新版本（默认）
curl -fsSL https://claude.ai/install.sh | bash
# 安装稳定版本（生产环境推荐）
curl -fsSL https://claude.ai/install.sh | bash -s stable
# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
（3）验证安装并配置 PATH
安装完成后，重新打开终端（或执行 source ~/.bashrc），验证 claude 命令是否可用。
# 重新加载 shell 配置
source ~/.bashrc # 或 source ~/.zshrc
# 验证 claude 命令
claude --version
# 如果提示 command not found，手动将 ~/.local/bin 添加到 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 运行健康检查
claude doctor
如果一切顺利，claude --version 会输出当前安装的版本号，claude doctor 会显示安装类型和系统状态的全面检查报告。
3.3 macOS 安装配置
macOS 是 Claude Code 支持最完善的平台之一,macOS 用户不需要像 Windows 那样额外安装 Git Bash，系统自带的 Terminal 和 Bash/Zsh 就是最佳运行环境。
（1）确认系统版本
Claude Code 要求 macOS 13.0（Ventura）或更高版本。同时支持 Intel 和 Apple Silicon（M1/M2/M3/M4）架构。
# 查看 macOS 版本
sw_vers
# 查看处理器架构
uname -m
# 输出 arm64 表示 Apple Silicon, x86_64 表示 Intel
（2）执行原生安装（推荐）
打开 Terminal（终端），执行以下命令。安装脚本会自动检测你的 Mac 是 Intel 还是 Apple Silicon 架构，下载对应的二进制文件。安装完成的二进制文件经过 Apple 公证（Notarized），并由「Anthropic PBC」签名，确保安全性。
# 安装最新版本（默认）
curl -fsSL https://claude.ai/install.sh | bash
# 安装稳定版本
curl -fsSL https://claude.ai/install.sh | bash -s stable
（3）验证安装
安装完成后，与 Linux 一样，验证命令是否可用：
# 重新打开终端或重新加载配置
source ~/.zshrc # macOS 默认使用 Zsh
# 验证版本
claude --version
# 健康检查
claude doctor
macOS 用户通常不会遇到 PATH 问题，因为 ~/.local/bin 在大多数 macOS 配置中已经包含在默认 PATH 中。如果确实遇到了，添加方式与 Linux 相同。
4. 账户注册与登录认证
安装之后，接下来需要完成账户准备和登录认证，让 Claude Code 真正可用。
4.1 方式一：官方订阅
Claude Code 需要 Claude Pro、Max、Team 或 Enterprise 订阅才能使用。
（1）登录 Claude.ai
访问 claude.ai，点击 "Continue with Google" 使用 Google 账号一键登录，由于国内经常被封禁，这里就不细讲了。
4.2 方式二：通过 CC-Switch 管理 API Key 接入
除了官方订阅之外，Claude Code 还支持通过第三方模型 API 接入的方式使用，这对于国内用户而言尤为重要。
借助社区开源工具 CC-Switch，我们可以一键切换到 MiniMax-M2.5、GLM-5、DeepSeek 等国内大模型，在 Claude Code 的交互框架中使用更经济、访问更稳定的模型服务。本节将以 MiniMax-M2.5 为例，完整演示从工具安装到模型切换的全流程。
（1）CC-Switch 是什么
CC-Switch 是一款由社区开发者主导构建的跨平台桌面应用，核心职责是统一管理多个 AI CLI 工具的供应商配置与运行环境。
CC-Switch 是一个托管在 GitHub 上的开源项目，项目地址为 farion1231/cc-switch。它的 Slogan 是「The All-in-One Manager for Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw」。
从 GitHub 仓库的 Releases 页面可以看到，项目维护非常活跃，提供多种安装格式，包括 Windows 的 .msi 安装包、macOS 的 .tar.gz 包以及 Linux 的 .AppImage 和 .deb/.rpm 格式，几乎覆盖了主流的桌面操作系统环境。
CC-Switch 核心功能模块一览
| 功能模块 | 功能描述 |
|---|---|
| 供应商管理 | 创建、切换、管理多个 API 供应商配置，支持一键激活，内置 20+ 预设供应商 |
MCP 服务器管理 | 统一配置 Model Context Protocol 服务器，跨工具同步，支持导入导出 |
| 系统提示词管理 | 多套提示词预设，支持 Markdown 实时预览与快速切换 |
| Skills 市场 | 从 GitHub 自动发现并一键安装 Claude Skills，无需手动操作 |
| 端点测速 | 内置延迟测量工具，可视化评估各供应商响应质量 |
| 配置备份 | 自动备份与恢复，支持跨设备同步 |
打开 CC-Switch 主界面后，顶部导航栏展示了它所支持管理的五类工具：Claude、OpenAI、Gemini、OpenCode、 和 OpenClaw。每个标签页下都可以独立管理供应商配置，互不干扰。这种设计意味着，你可以为同一工具维护多套配置——例如在 Claude 标签下同时保留官方 Claude、MiniMax 和 DeepSeek 的接入配置，按需一键切换，完全不需要每次手动修改环境变量或配置文件。
（2）为什么更推荐国内用户使用 CC-Switch
使用原生 Claude 的现实门槛
| 门槛类型 | 具体问题 | 影响程度 |
|---|---|---|
| 网络访问 | 需要稳定的代理工具，且 Claude 会主动检测异常 IP | 高 |
| 账号注册 | 需要海外手机号验证，注册流程繁琐，随时可能被封号 | 高 |
| Token 费用 | Claude Max 套餐约 $100/月，按量计费更昂贵 | 高 |
| 支付方式 | 需要 Visa/MasterCard 等国际信用卡，国内银行卡不支持 | 中 |
支持 Claude API 协议的国内主流大模型对比
| 模型 | 提供商 | 编程能力特点 | 价格参考 |
|---|---|---|---|
| MiniMax-M2.5 | MiniMax | SWE-Bench 76.3%，SOTA 编码与 Agent 能力 | Coding Plan 月套餐 ¥29 起 |
| GLM-5 | 智谱 AI | 国内商业落地成熟，中文表现优秀 | 按量计费，有免费额度 |
| Qwen-Coder | 阿里云 | 代码生成能力强，开源版可本地部署 | 按量计费，有免费额度 |
| DeepSeek-V3.2 | DeepSeek | 推理与代码能力突出，价格极具竞争力 | 按量计费，极低单价 |
其中 MiniMax-M2.5 是目前在 Claude Code 生态中接入体验最为完整的国内模型之一——它不仅原生兼容 Anthropic 协议，CC-Switch 也将其作为首批预设供应商之一，配置过程几乎不需要手动填写任何技术参数，只需提供 API Key 即可完成接入。
当你需要在不同项目中使用不同模型时——例如日常开发用 MiniMax，特定任务切回 Claude Official——不再需要记忆和维护多套环境变量，打开应用切换一下即可。
（3）以 MiniMax 为例：完整配置流程
整个流程分为四个步骤：下载安装 CC-Switch、获取 MiniMax API Key、在工具中添加供应商配置，以及最终启用并验证效果。
注意： 在开始前，如果你的系统中已手动设置了 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_BASE_URL 等环境变量，需要先将其清除，避免与 CC-Switch 写入的配置产生冲突。
步骤一：下载并安装 CC-Switch
第一步需要从 GitHub 获取与当前操作系统匹配的安装包。CC-Switch 的所有发行版均托管在 GitHub Releases 页面，本步骤的判据是：安装完成后，CC-Switch 主界面能够正常打开，并显示包含 Claude、Codex、Gemini、OpenCode 四个标签页的默认界面。
（1）前往 GitHub Releases 页面选择安装包
访问 github.com/farion1231/… Assets 列表中根据操作系统选择对应的安装包格式。
（2）运行安装程序，完成安装向导
以 Windows 为例，双击下载的 .msi 文件，按照安装向导提示点击「Next」完成安装。向导最后一页出现「Completed the CC Switch Setup Wizard」提示时，保持勾选「Launch CC Switch」选项，然后点击「Finish」，程序将在安装完成后自动启动。
步骤二：获取 MiniMax API Key
（1）注册账号并订阅 Coding Plan 套餐
访问 platform.minimaxi.com，注册并登录账号后进入「Coding Plan」订阅页面。
（2）在 Coding Plan 控制台复制 API Key
完成套餐订阅后，进入 Coding Plan 控制台页面。页面下方的「API Key」区域会展示当前账号的密钥（以 sk- 开头），点击右侧的「复制并重置」按钮获取完整的 API Key 字符串，备用于下一步配置。
步骤三：在 CC-Switch 中添加 MiniMax 供应商
到 CC-Switch 主界面，开始添加 MiniMax 作为新的 Claude 供应商。这一步的核心优势在于：CC-Switch 已为 MiniMax 内置了完整的预设配置，我们只需填写 API Key 一个字段，其余所有参数由工具自动填充。本步骤的判据是：主界面供应商列表中出现了 MiniMax 条目。
（1）点击右上角 + 按钮，进入添加供应商页面，选择MiniMax
在 CC-Switch 主界面右上角，找到橙色的「+」按钮并点击，进入「添加新供应商」页面，选择MiniMax。
选择 MiniMax 后，可以看到「请求地址」字段已自动填充为 api.minimaxi.com/anthropic，这… MiniMax 专门为兼容 Claude API 协议提供的端点地址，无需手动修改。
（3）填入 API Key，点击添加完成注册
在「API Key」输入框中粘贴上一步从 MiniMax 控制台复制的密钥，然后点击右下角的蓝色「+ 添加」按钮完成配置。此时官网链接、请求地址、API 格式等字段均已自动填充，无需额外修改。
添加成功后，CC-Switch 自动返回主界面，可以看到 MiniMax 已作为新条目出现在供应商列表中。
步骤四：启用 MiniMax 配置并验证接入效果
添加供应商只是把配置信息录入了 CC-Switch，真正生效还需要执行「启用」操作。启用后，CC-Switch 会将 MiniMax 的 API Key、Base URL 等参数写入 Claude Code 的配置文件，下次启动 Claude Code 时将自动使用 MiniMax 作为底层模型。本步骤的最终判据是：在 Claude Code 终端中询问模型身份，回答中出现「MiniMax-M2.5」字样。
（1）点击 MiniMax 条目上的「启用」按钮使配置生效
在主界面的供应商列表中，找到 MiniMax 条目，点击右侧的蓝色「启用」按钮。启用成功后，按钮状态会变为「使用中」，表示配置已写入 Claude Code 的环境配置文件。
如需了解 CC-Switch 在后台具体写入了哪些参数，可以点击条目右侧的编辑图标查看配置 JSON。可以看到，CC-Switch 自动为 Claude Code 写入了以下关键环境变量：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-...",
"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
"ANTHROPIC_MODEL": "MiniMax-M2.7",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"autoUpdatesChannel": "latest"
}
这些正是 Claude Code 识别并调用第三方模型所需的全部配置，CC-Switch 帮助我们自动完成了原本需要手动维护的所有配置工作。
（2）打开 Claude Code 终端，验证 MiniMax 接入是否成功
完成启用后，关闭当前所有终端窗口，重新打开一个新的终端，执行 claude 命令启动 Claude Code。进入主界面后，直接提问「你好，请问你是什么模型？」来验证模型是否已切换为 MiniMax。
成功切换到 MiniMax 后，Claude Code 欢迎界面变为「MiniMax-M2.5 · API Usage Billing」，同样的问题得到的回答变为「我当前使用的是 MiniMax-M2.5 模型」——这说明接入已经完全生效：
至此，CC-Switch 接入 MiniMax 的完整流程已全部走通。整个过程不涉及任何手动编辑配置文件的操作。切换其他国内供应商（如 DeepSeek、智谱 GLM、Kimi 等）的流程与此完全一致，只需重复步骤三和步骤四即可——选择对应的预设供应商，填入 API Key，点击启用。
如果启动
Claude Code后仍显示原有模型，可能是因为系统中存在旧的 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_BASE_URL 系统环境变量，其优先级高于 CC-Switch 写入的配置。建议检查系统级环境变量并将其清除后重新启动终端再试。
5. 基本命令速查
整理一份日常使用中最高频的 Claude Code 命令速查表。这些命令覆盖了启动、查询、Git 操作和会话管理等核心场景：
Claude Code 日常命令速查表
| 命令 | 功能 | 示例 |
|---|---|---|
claude | 启动交互模式 | claude |
claude "task" | 运行一次性任务 | claude "fix the build error" |
claude -p "query" | 查询后自动退出 | claude -p "explain this function" |
claude -c | 继续最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude commit | 创建 Git 提交 | claude commit |
claude doctor | 安装健康检查 | claude doctor |
claude update | 手动更新 | claude update |
/help | 显示帮助（会话内） | > /help |
/clear | 清除对话历史 | > /clear |
/compact | 压缩上下文 | > /compact |
/login | 登录/切换账户 | > /login |
exit 或 Ctrl+C | 退出 Claude Code | > exit |
至此，Claude Code 的本地部署与配置教程就全部完成了。
我们从认知层面理解了它的产品定位，通过与 Cursor 和 Codex 的对比建立了选型认知，在三大操作系统上完成了安装配置，完成了账户注册与登录认证，并通过分层验证确认了部署结果，并整理了常见问题排查表和命令速查表。
掌握了这些内容，你已经具备了在实际项目中高效使用 Claude Code 的基础。
后续课程中，我们将深入探讨 CLAUDE.md 的最佳实践、MCP 协议的高级用法、以及如何通过 Hooks 和 Skills 构建团队级的自动化工作流。
