AI编程新利器：Claude Code国内配置全攻略（附CC-Switch一键搞定API Key）

“编程零基础，也能靠AI写出完整程序？”

“Claude Code在国内到底能不能用？”

“为什么别人一句话就能生成一个软件？”

坦白说，现在的AI编程已经进化到了 会说话就能写代码 的阶段。而目前公认最强的AI编程命令行工具之一，就是 Claude Code。

Claude Code是什么？为什么它是CLI形态？

Claude Code 是 Anthropic 推出的AI编程助手，基于其最新的Claude大模型构建。在目前的AI编程工具中，它被普遍认为超越了Cursor、Augment、Kiro等同类产品。

那么它为什么采用CLI（命令行界面）这种看似复古的形式？
CLI 就是那个黑底白字的窗口，你得通过键盘输入指令来指挥电脑。而 Claude Code 这类AI编程CLI，更像是一个“驻守在终端里的AI程序员代理”——它不仅能读写代码，还能直接执行代码、安装依赖、提交Git、甚至检索你电脑里的文件。这种 万能钥匙 般的权限，让它能真正像人类程序员一样行动，而不仅仅是文本补全。

国内使用的痛点与解决方案

Claude Code虽强，但在国内直接使用会遇到网络限制、API Key配置混乱、BASE_URL设置繁琐等问题。很多人启动后发现无法对话，各种报错让人头大。

为此，我们借助一款开源小工具 CC-Switch，它能一键搞定所有配置，让你像点开关一样切换不同API供应商。

本文专为“纯小白”设计：你不需要懂编程，只需会复制粘贴，跟着步骤一步步操作即可。

一、准备工作——安装两大基础环境

Claude Code运行需要两个基础软件：Node.js 和 Git。

• Node.js：Claude Code的运行环境。
• Git：用于代码版本管理，Claude Code也会调用它。

这两款软件的安装非常简单，网上有大量图文教程，你可以自行搜索 Node.js安装教程 和 Git安装教程 ，根据你的操作系统（Windows/macOS）下载安装包，一路默认设置即可。

node --version
git --version

如果能显示出版本号（如 v22.x.x 等），说明环境就绪。

二、安装主角——Claude Code

打开终端（Mac的终端或Windows的命令提示符），输入以下命令：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

该命令会从国内镜像源下载并全局安装Claude Code。安装过程需要联网，稍等片刻即可。

claude --version

如果能显示版本号，说明Claude Code已成功入驻你的电脑。

三、获取“通行证”——API密钥

Claude Code本身不提供免费模型，需要你配置API密钥才能调用AI能力。这里有两条路线可选：

方案A：使用中转站（可调用Claude官方模型）

推荐使用 UniVibe 中转站，新用户注册即送3000永久积分，邀请好友双方还能都再得3000积分。
注册链接：https://www.univibe.cc/console/auth?type=register&invite=ZSH8ZC
邀请码：ZSH8ZC（注册时填入）
注册时需要手机号验证，注意接听来电。
登录后，进入 API密钥 页面，点击 创建密钥，随便起个名字，生成后立即复制保存（以 sk- 开头，只显示一次）。

方案B：接入国内模型（以智谱AI为例）

智谱 GLM Coding 通过邀请链接注册立减10%

1. 先注册：https://www.bigmodel.cn/glm-coding?ic=OQWTKQUHIM
2. 注册后领取7天AI Coding体验卡：https://bigmodel.cn/activity/trial-card/GQ6YVTWLFU

后续也可购买每月20元的GLM Coding Plan套餐。
获取API Key：访问智谱AI API密钥页面，创建新的API Key并复制。

（两种方案任选其一即可，推荐先尝试UniVibe，体验更接近官方Claude模型）

这里可以获取更多的 Claude中转站分享及国内的AI Coding Plan大全

四、用CC-Switch一键配置API Key

CC-Switch 是一款开源桌面工具，专门用来统一管理Claude Code等AI编程助手的配置。它让你无需手动编辑JSON文件，只需在图形界面中添加供应商信息，即可自动生效，还能随时切换账号。

下载CC-Switch

• GitHub官方发布页：https://github.com/farion1231/cc-switch/releases/tag/v3.10.3
  

  

• 备用网盘（夸克）：https://pan.quark.cn/s/c56a2f2f0634

• 备用网盘（UC）：https://drive.uc.cn/s/fbab306d08a44?public=1

  

下载后解压/安装，打开CC-Switch。

添加供应商配置

点击界面上的 “+” 或 “添加” 按钮，根据你选择的方案填写：

以UniVibe为例：

• 供应商名称：UniVibe（可自定义）
• 官网链接：https://www.univibe.cc/
• API Key：粘贴你从UniVibe复制的 sk-... 密钥
• 请求地址（BASE_URL）：https://api.univibe.cc/anthropic

以智谱AI为例：

• 目前CC-Switch已经预设了一些常用的供应商，这里可以直接选择 Zhipu GLM
• 供应商名称：Zhipu GLM
• API Key：粘贴智谱的API Key
• BASE_URL：https://open.bigmodel.cn/api/anthropic

填写后点击 添加，然后在该供应商卡片上点击启动。

CC-Switch会自动将配置写入Claude Code的设置文件，无需任何手动操作。

五、启动与测试——召唤你的AI程序员

一切就绪，现在回到终端，输入命令：

claude

首次启动可能会让你选择界面风格，直接回车选默认即可。稍等片刻，你会看到终端底部出现一个闪烁的光标 ❯。

输入测试命令：

/status

如果返回的信息中包含你配置的BASE_URL地址（如 univibe.cc 或 bigmodel.cn），那么恭喜你——配置成功！你已经拥有了一个强大的AI编程助手。

六、实操案例——让AI帮你“变出”贪吃蛇游戏

理论知识说再多，不如动手玩一次。这一节，我们就让Claude Code根据你的需求，现场生成一个完整的网页版贪吃蛇游戏。你只需把要求告诉它，它就会像资深程序员一样，给出可直接运行的代码。

准备工作：新建项目文件夹

1. 在你电脑的合适位置（比如桌面），新建一个文件夹，命名为 snake-game。

2. 打开这个文件夹，在文件夹地址栏输入 cmd 并回车（Windows），或者右键选择“在终端打开”（Mac），这样终端就会直接定位到当前文件夹。

   

3. 在终端中输入 claude 并回车，启动Claude Code。

现在，你已经在项目目录下打开了AI程序员，可以开始对话了。

向AI提出需求

将下面这段需求完整地复制，粘贴到Claude Code的输入框（❯ 后面），然后按回车发送：

你是一名资深前端工程师，请帮我开发一个【网页版贪吃蛇游戏】。技术要求：
1. 使用 HTML + CSS + JavaScript
2. 不依赖任何第三方框架
3. 页面布局简洁，适合新手理解

功能要求：
1. 使用键盘方向键控制蛇的移动
2. 自动生成食物，吃到后蛇身变长
3. 实时显示当前分数
4. 撞墙或撞到自己时游戏结束
5. 提供“重新开始”按钮

交付要求：
1. 给出完整项目结构说明
2. 给出全部代码（可直接复制使用）
3. 告诉我如何在本地运行这个游戏
4. 关键逻辑请用中文注释说明

AI的响应

Claude Code会先分析需求，然后生成一系列文件。通常它会输出类似下面的内容（实际生成可能略有不同，但功能一定满足）

写在最后

至此，你已经完成了从环境搭建到API配置的全部步骤，成功让Claude Code在国内跑起来了。现在你可以像那些 一句话生成软件 的玩家一样，用自然语言指挥AI帮你写代码、修bug、甚至部署项目。而你只需要学会一件事，怎么把需求说清楚。

如果过程中遇到任何问题，欢迎在评论区留言交流。祝你在AI编程的世界里玩得开心！