Claude Code国内使用指南：从安装到接入国产模型，手把手教学

还在羡慕大佬在黑窗口里敲几行命令就能搞定整套项目？

看到 Claude 官方封号严重、订阅价格又高，只能干瞪眼？

完全没必要放弃！下面就一步步教你在国内环境下，用国产大模型做平替，让你一样可以畅用这款当前非常强大的 AI 编程工具 —— Claude Code (CC)。

尤其是 Claude Code 2.1 发布之后，一次性更新了 80 多项功能，支持的工作流更复杂、响应也更智能，非常值得折腾起来用一用。

直接进入实操步骤。

一、 前期准备

正式安装前，建议先把以下环境配置好：

• 1. 准备好稳定、可访问外网的网络环境（科学上网优先，能减少各种网络报错）。
• 2. 安装最新版本的 Node.js：
     https://nodejs.org/en/download/
• 3. Windows 用户还需要额外安装 Git for Windows：
     https://git-scm.com/install/windows

这些环境只需要安装一次，后面无论升级还是重装 Claude Code 都会很轻松。

二、 核心步骤1：安装 Claude Code

前提环境准备完之后，就可以开始正式安装 Claude Code 了。

1.搜索并打开你电脑的终端工具。

根据不同系统打开终端：

• Windows：按快捷键 Win + R，输入 cmd 并回车，就能打开命令提示符。
• Mac：按 Command（⌘）+ 空格 调出搜索，输入“终端”并回车即可。

2.输入命令

在终端中，直接复制粘贴下面这行命令，然后回车执行：

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

这条命令会通过 npm 全局安装 Claude Code，整个过程需要一点时间，取决于你的网络和 npm 镜像速度。

3.验证是否安装成功

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

claude --version

如果终端能正常返回一个版本号，说明 Claude Code 已经安装成功。

接着在终端输入：

claude

如果看到类似下面的 Claude 欢迎界面，就说明程序可以正常启动，第一步已经完成。

三、 核心步骤2：配置 API Key

很多人卡在这一步：众所周知，Claude 官方风控非常严格，频繁封号是常态，再加上订阅成本不低，所以更推荐在国内直接使用国产大模型来做平替。

如果选择使用 Claude 原生 API 或其他海外 API，一般还要额外配置代理和网络转发，这里暂不展开，有需求可以单独查阅类似“如何配置海外 AI API 代理”这类教程。

国产模型方面，像智谱 AI、Kimi、DeepSeek 都已经可以较好地支持编程与代码理解，其中智谱支持快捷配置，对新手极其友好。下面以几家主流平台为例说明。

1.获取密钥

首先去各平台的开放平台申请 API Key，并确保账号里有可用额度（调用接口会消耗 token，没额度会直接报错）：

智谱AI开放平台：https://www.bigmodel.cn/glm-coding?ic=IFWXL8ET6B
Kimi开放平台：https://platform.moonshot.cn/
DeepSeek开放平台：https://platform.deepseek.com/

注册并登录后，在「个人中心」或「API 管理」里生成对应的密钥，注意妥善保存，不要泄露给他人。

如果你想进一步对比各家模型的特点和计费方式，可以参考类似《国内主流大模型对比与选型》这类文章，帮助你选出适合项目的模型。

2.配置Claude Code服务器

接下来就是把 API Key 和模型地址告诉 Claude Code。

① 快捷配置（智谱AI）

如果你打算使用智谱 AI，官方已经提供了非常方便的一键配置工具。

在终端中输入：

npx @z_ai/coding-helper

稍等片刻，就会弹出配置界面。

通过键盘的上下方向键移动光标，按回车进行选项确认和下一步。

接着根据界面的中文提示，粘贴刚才从智谱平台获取的 API Key，按指引一步步完成，即可把相关配置写入 Claude Code 所用的环境中。

这种方式适合不想手动写环境变量、偏向傻瓜式安装的新手用户。

② 手动设置（其他国产模型）

如果你选择的是 Kimi、DeepSeek 或其他兼容 Anthropic 协议的国产模型，就需要手动配置环境变量。下面以 Kimi 为例演示。

在终端中配置环境变量（注意：这种方式只对当前终端会话有效，关闭窗口后会失效，想长期生效可以写入 shell 配置文件或系统环境变量）。

• macOS 和 Linux：

# Linux/macOS 启动高速版 kimi-k2-turbo-preview 模型
export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_AUTH_TOKEN=${YOUR_MOONSHOT_API_KEY}
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview

# 启动 claude
claude

• Windows（PowerShell）：

# Windows PowerShell 启动高速版 kimi-k2-turbo-preview 模型
$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"
$env:ANTHROPIC_MODEL="kimi-k2-turbo-preview"
$env:ANTHROPIC_SMALL_FAST_MODEL="kimi-k2-turbo-preview"

# 启动 claude
claude

在这里：

• ANTHROPIC_BASE_URL：填你要使用的服务商提供的兼容 Anthropic 协议的网关地址；
• ANTHROPIC_AUTH_TOKEN：填对应平台生成的 API Key；
• ANTHROPIC_MODEL 和 ANTHROPIC_SMALL_FAST_MODEL：填该平台提供的模型名称，如 kimi-k2-turbo-preview。

如果你想了解更多关于 API 网关和模型路由的知识，可以额外阅读一些类似《Anthropic 兼容 API 网关说明》的资料，会更容易理解这些变量的含义。

3.确认配置是否生效

完成配置后，在 Claude Code 的对话窗口中输入：

/status

用于查看当前使用的版本、模型以及接口状态。

如果能看到你刚刚设置的模型名称和接口地址，且状态正常，就说明配置生效了。若报错，多半是 API Key 填写错误、余额不足或者 BASE_URL 地址不正确，可以逐一检查。

4.后续启动与使用

至此，你已经拥有一个可用的、接入国产大模型的 Claude Code 环境。

以后每次使用，只需要在终端所在的项目目录里输入：

claude

然后回车，就能打开交互界面，如下图所示：

建议把常用的环境变量写入到你的 shell 启动文件（例如 ~/.bashrc、~/.zshrc 或 Windows 系统环境变量）中，这样每次打开终端都能直接运行 claude，无需重复配置。

四、 更多进阶技巧

安装完成只是开始，想用得顺手高效，下面这些技巧非常关键。

1.文件夹即上下文

Claude Code 最大的优势之一，就是可以把当前目录当作上下文理解。

建议为每个项目新建一个专门的文件夹，例如“AI项目”、“demo-电商后台”、“数据分析脚本”等，把项目代码、需求文档、接口说明等相关文件都放进去，然后在该目录下输入：

claude

这样 Claude Code 就能根据整个目录结构理解你的项目，相当于给它提供了“完整的工程现场”，在重构、查 bug、写测试、重命名变量等方面会更智能。

如果你想进一步学习如何用 AI 管理和理解大型项目结构，可以看看类似《用 AI 管理代码仓库的最佳实践》的文章，思路会更加清晰。

2.粘贴图片

Claude Code 也支持图像作为辅助信息，例如你可以把报错截图、UI 页面设计图、流程图等扔给它看。

具体操作：

• 截好图后复制到剪贴板；
• 在 Claude Code 的终端界面中：
  • macOS 使用快捷键 Control + V；
  • Windows 使用快捷键 Alt + V；

就可以把图片直接粘贴到会话中，方便它根据你的截图分析问题，例如报错页面、控制台错误、设计稿等。

3.恢复与查看历史对话

在开发过程中，经常会遇到重启终端、误关窗口、或者临时中断的情况。Claude Code 支持恢复历史对话：

• 直接回到上一次对话：

  claude -c
  

• 打开历史会话列表，选择需要恢复的记录（使用频率更高）：

  claude -r
  

通过这个方式，你可以把一个项目的调试过程拆成多次对话进行，不用担心中断后上下文丢失。

4.卸载Claude Code

如果你想清理环境或重装，可以通过 npm 卸载：

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

卸载后，相关的全局命令会被移除，如果要重新安装，重复前面的安装命令即可。

5.常用命令

熟练掌握一些内置命令，可以大幅提升使用体验：

/init     ：初始化当前项目，生成 `CLAUDE.md` 文件，相当于给 AI 提供一份“项目使用说明书”或“开发文档入口”。 

/status   ：查看当前版本、使用的模型、接口地址和代理状态，排查异常很有用。 

/clear    ：当你感觉对话“跑偏”或者上下文太乱时，直接清空当前对话，从头开始。 

/compact  ：当对话长度较长、上下文有“遗忘风险”时，用它压缩对话，只保留关键内容。 

/model    ：查看或切换当前可用的 AI 模型（前提是你配置了多个模型）。 

配合这些命令，你可以把 Claude Code 当作一个真正的“编程助理”和“通用 Agent”，不仅能写代码，还有能力帮你做工程规划、接口设计、数据清洗、脚本生成等多种工作。

如果你对模型切换、上下文压缩等机制感兴趣，可以查阅类似《多模型协同与上下文管理实战》这样的进阶内容，进一步挖掘 Claude Code 的潜力。

不得不说，Claude Code 的出现，极大地降低了“让 AI 直接写代码、改项目、查 bug”的门槛，即使是新手也能很快上手，体验到“指挥 AI 干活”的感觉。

它不只是一个写代码的小工具，更可以被当成你的通用智能助手：

• 批量处理和分析表格数据；
• 重新设计网页布局、改样式；
• 生成 API 文档与使用示例；
• 阅读和总结复杂项目的业务逻辑。

万事开头难，而最难的安装和配置步骤，你已经完成了。

接下来的事，就是多在自己的真实项目里用它聊天、调试、重构，一步步摸索出属于你的工作流和“Wow moment”。

如果你在安装或使用过程中遇到任何报错、连不通、模型不生效等问题，都可以在评论区具体贴出你的命令和报错信息，方便精准排查。