Claude Code国内使用指南：从安装到接入国产模型，手把手教学
还在羡慕大佬在黑窗口里敲几行命令就能搞定整套项目？
看到 Claude 官方封号严重、订阅价格又高，只能干瞪眼？
完全没必要放弃！下面就一步步教你在国内环境下，用国产大模型做平替，让你一样可以畅用这款当前非常强大的 AI 编程工具 —— Claude Code (CC)。
尤其是 Claude Code 2.1 发布之后，一次性更新了 80 多项功能，支持的工作流更复杂、响应也更智能，非常值得折腾起来用一用。
直接进入实操步骤。
一、 前期准备
正式安装前，建议先把以下环境配置好：
-
- 准备好稳定、可访问外网的网络环境（科学上网优先，能减少各种网络报错）。
-
- 安装最新版本的 Node.js：
https://nodejs.org/en/download/
- 安装最新版本的 Node.js：
-
- Windows 用户还需要额外安装 Git for Windows：
https://git-scm.com/install/windows
- Windows 用户还需要额外安装 Git for 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；
- macOS 使用快捷键
就可以把图片直接粘贴到会话中，方便它根据你的截图分析问题，例如报错页面、控制台错误、设计稿等。
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”。
如果你在安装或使用过程中遇到任何报错、连不通、模型不生效等问题，都可以在评论区具体贴出你的命令和报错信息，方便精准排查。
原创文章，作者：kp51，如若转载，请注明出处：https://www.kepu51.com/instant-messaging/538.html
