国内环境下的Claude Code安装与使用教程

随着AI的发展，手敲代码时代真是一去不复返，对于开发人员来说，最起码已经使用上了IDE中的AI插件，用来辅助代码的生成。

如果想更进一步，那就非基于自然语言的Vibe Coding了，目前支持的比较好的开发工具又非Claude Code莫属。这篇文章就带大家从零开始，在本机环境中安装Claude Code，通过CC Switch配置国内模型，让大家在国内环境中也可以正常使用Claude Code。最后，再演示一个简单的案例。

现在我们开始。

什么是Claude Code？

在开始之前，先简单了解一下Claude Code，Claude Code是Anthropic推出的面向开发者的 AI 编程协作工具。它可以读取代码库、编辑文件、运行命令、构建功能、修复错误和自动化开发任务，并且可以开发工具集成。

Claude Code可以理解你的整个代码库，可以跨多个文件和工具工作以完成任务。而在这个过程中，需要你做的可能就是通过自然语言来描述任务，并且检查和确认结果。

目前市面上有许多Agent框架的产品，比如OpenClaw、Hermers Agent等等，但不得不承认，目前最好的还是Claude Code。

但是由于地区的封锁和限制，在实践的过程中，很多朋友会遇到一个问题，那就是在国内环境下无法正常使用Claude Code。即便通过翻墙的方式进行使用，也很快会被封掉。这也是这篇文章我们要解决的一个重点问题。

其实，Claude Code本质上是由Agent框架+模型服务组成的，当在Claude Code中使用Claude模型时，非常容易会被封，但Claude Code这个Agent框架的软件是不会被封的。

这时，我们就可以使用Claude Code搭配国产模型来使用Claude Code，效果也是非常不错的。下面我们开始具体的安装和实践。

Claude Code安装

Claude Code的安装可以有多种方式，官方也提供了各类操作系统的不同安装方式。这篇文章以MacOS操作系统为例，采用其中的一些比较快捷的安装方式来进行演示。其他方式大家可以参考对应操作系统的文档进行执行即可。

官方提供的最简单的安装方式是直接通过curl命令脚本来安装：

curl -fsSL https://claude.ai/install.sh | bash

这种安装方式需要注意的是，使用这种方式安装需要具备翻墙能力。

如果不具备翻墙能力，也可以使用MacOS比较流行的命令行包管理器——homebrew，利用homebrew可以使用一条命令就能够安装、更新、卸载各类软件和开发工具。

在使用之前先检查一下对应的操作系统是否安装homebrew，如果没有安装需要提前准备安装一下，这里不再展开。

基于homebrew的安装命令：

brew install --cask claude-code@latest

执行命令结果：

当执行完安装之后，可执行查看版本的命令，来查看是否安装成功。

查看版本：

claude --version

如果有对应的版本号输出，则说明安装成功了。

当首次安装完成之后，如果直接执行claude命令会展示如下结果：

这里表示已经安装成功了，上面红色的提示信息是Claude Code在尝试连接Anthropic API时报错，这里暂时忽略，后面我们通过配置模型服务商来解决。

Claude Code模型服务配置

如果你有Claude的账号且没有网络访问的问题，那么在首次使用Claude Code时，执行login命令进行登录即可：

/login# 按照提示输入账号登录

但对于大多数国内用户来说，通常没有Claude的账号，或者没有适合使用的网络。此时，我们就可以通过国产模型来使用Claude Code。这里就要用到一款软件——CC Switch。

什么是CC Switch？

CC Switch的Github地址为：https://github.com/farion1231/cc-switch，上面有非常详细的功能介绍，这里只做简单概述。

CC Switch是一款支持Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的全方位管理工具。上述的每个工具都有自己的配置格式，当切换API供应商时便意味着要手动编辑 JSON、TOML 或 .env 文件，而在多个工具之间缺乏一个统一管理MCP，SKILLS的方式。

CC Switch提供了一个桌面应用来管理所有五个CLI工具。无需手动编辑配置文件，通过可视化界面，一键将供应商导入应用，一键在不同的供应商之间进行切换，内置50+供应商预设、统一的MCP，SKILLS管理以及系统托盘即时切换功能——所有操作都基于可靠的SQLite数据库和原子写入机制，保护配置不被损坏。

总之，CC Switch就是一款管理像Claude Code这类工具的模型服务商API KEY以及一些基础配置的工具。

CC Switch安装

在前面安装Claude Code时，如果采用了homebrew的安装方式，这里依然可以通过homebrew快速安装CC Switch，也是官方推荐的安装方式。

执行安装命令：

brew tap farion1231/ccswitchbrew install --cask cc-switch

更新命令：

brew upgrade --cask cc-switch

当然，也可以通过Github的Release页面来进行手动下载安装，地址为：https://github.com/farion1231/cc-switch/releases。

CC Switch配置模型API KEY

当CC Switch安装完成，打开软件，可以看到支持Claude Code、Codex、Gemini CLI、OpenCode和OpenClaw五款工具的模型供应商，其中包括“导入当前配置”和“添加供应商”两种方式。

这里采用添加供应商的模式，选择“Claude”，点击右上角的加号。

在添加新供应商页面选择需要配置的模型，这里采用智谱的GLM国内版。当选择模型之后，CC Switch会自动填充该模型的一些基础信息，比如名称、官网等。

在API Key填写模型服务商提供的API Key，其他参数CC Switch会自动帮忙填写完成。

配置上述两个信息之后，点击保存，完成配置，后续在Claude Code中便可直接使用了。

Claude Code简单案例

经过上述步骤，Claude Code的安装已经完成，并且配置好了要使用的模型服务商API Key。下面我们来启动Claude Code，并尝试一些简单的使用案例。

首次启动与配置

创建一个供Claude Code工作的目录空间，然后通过命令行进入该目录下，执行Claude的启动命令：

claude

首次启动时需要初始化一些基础设置，比如颜色风格（后续可通过执行/theme来进行修改）、安全提示、是否使用Claude Code终端设置（采用默认即可）、目录是否可信等。这个可根据个人需要来进行设置，一路回车即可。

当执行完上述配置之后，即可进入到Claude Code的对话界面。

对话页面就是我们通过自然语言与Claude Code交流、指挥它干活的地方。

这里，询问它一个简单的问题，“你可以干什么？”：

可以看到，它检测到当前是一个空目录，并且展示了它支持的常见功能，以及可使用的一些技能（Skills）。

一个简单的案例

上面只是简单的询问和对话，下面我们让它执行一个编程指令，并且运行对应的程序。

按照编程的惯例，我们先来一个“Hello World”的案例，这里让它创建一个简单的HTML页面，在页面中呈现"Hello, Claude Code!"。

在这个案例中我们暂时不考虑Claude Code使用中的一些技巧和最佳实践，只是验证和演示一下它的编程能力。

在输入框输入“创建一个简单的HTML页面，显示"Hello, Claude Code!"，使用具有科技感、程序员风格的CSS样式。”

当执行完上述命令之后（中间需要一些确认，回车即可），查看项目目录，发现多了一个index.html文件，用浏览器打开文件，显示效果如图：

可以看到，这里生成了一个“有科技感”的“Hello Claude Code”页面。后续，可通过更多的对话来指挥Claude Code来干更多的事，大家可以自行尝试，这里就不再展开了。

小结

本篇文章首先带大家简单认识了一下Claude Code，针对国内环境+国内模型的场景演示了Claude Code的安装，以及CC Switch工具的配置和使用。最后，通过安装好的Claude Code生成了一个简单的HTML页面。

通过这一些列的操作，大家已经具备了一个可以通过自然语言来进行编程的环境，可以自行尝试探索各种功能。另外，在Claude Code的使用中，有一个非常重要的文件“CLAUDE.md”，也就是配置Claude在全局范围内以及项目范围内的规约，这个我们会单独开一篇文章来讲讲。后续也会逐步分析更多关于Claude Code的使用案例和最佳实践。