这篇文章主要解决一个问题：Claude Code 国内使用教程到底怎么搞，才能既不折腾、又稳定能用？
如果你是刷到这篇文章才第一次听说 Claude Code，先简单科普一下：
它是 Anthropic 官方推出的命令行 AI 编程工具，运行在你的本地终端里，可以读你的代码、改你的代码、跑你的项目、提交你的 git，本质上相当于把一个资深工程师塞进了你的命令行。
最近这一年它在开发圈的火爆程度，已经到了"没用过就跟不上节奏"的地步。
这篇文章主要解决一个问题：Claude Code 国内使用教程到底怎么搞，才能既不折腾、又稳定能用？
如果你是刷到这篇文章才第一次听说 Claude Code，先简单科普一下：
它是 Anthropic 官方推出的命令行 AI 编程工具，运行在你的本地终端里，可以读你的代码、改你的代码、跑你的项目、提交你的 git，本质上相当于把一个资深工程师塞进了你的命令行。
最近这一年它在开发圈的火爆程度，已经到了"没用过就跟不上节奏"的地步。
编辑
但国内用户想用上 Claude Code，门槛其实一直不低：网络问题、支付问题、最近还叠加了大规模封号问题。
所以这篇 Claude Code 国内使用教程，会优先讲一种完全不需要魔法、不需要卡、零封号风险的方案——把后端模型换成国产的 Kimi K2.5。
文章后半段，我会补充如何去订阅Claude会员，让你可以使用原汁原味的Claude账号。毕竟国产模型还在追赶的阶段。
整篇文章的重点会放在安装和配置这两个最容易卡住新手的环节上，每一步都给你写清楚，跟着做基本不会翻车。
一、为什么这篇 Claude Code 国内使用教程优先讲 Kimi 接入？
在进入正式教程之前，先花一分钟说清楚为什么我把 Kimi 放在第一位讲。
第一个原因是 Kimi 是国内极少数官方主动适配 Anthropic API 协议的大模型。大部分国产模型走的是 OpenAI 兼容路线，要接入 Claude Code 还得套一层转换代理，配置复杂还容易踩坑。
Kimi 直接给了一个原生的 Anthropic 端点（https://api.moonshot.cn/anthropic），Claude Code 可以无感切换，体感上跟用原版没什么区别。
第二个原因是 K2.5 这一代模型的 Agent 能力已经能打。
Moonshot 在 2026 年 1 月发布的 kimi-k2.5 支持 256K 上下文窗口，原生融合文本与视觉理解，在工具调用和多步任务上做了重点优化——而这恰恰是 Claude Code 这种 agent 式编程工具最吃的能力。
简单写脚本、跑项目重构、调 bug 这类日常任务，K2.5 的表现已经足够让你忘记自己用的不是原版 Claude。
第三个原因最实际：便宜、不封号、国内直连。
Kimi 的 token 价格只有 Claude 官方的零头，付款用支付宝微信都行，调用走国内网络丝滑流畅，更重要的是——它是国内合规的服务，不存在所谓"账号被封"的问题，你充进去的钱永远是你的。
OK，原因说完了，下面进入正题。
二、Claude Code 安装：先把环境搭起来
无论你最后用 Kimi 还是用官方 Claude，Claude Code 这个客户端本身都得先装好。这一步对所有方案都通用。
1. 安装 Node.js（前置依赖）
Claude Code 是基于 Node.js 运行的，所以第一步要把 Node 装上。版本要求是 18 或更高，建议直接装最新的 LTS 版本省事。
Windows 用户：去 Node.js 官网（nodejs.org）下载 LTS 安装包，双击安装，一路 Next 即可。安装完成后打开 PowerShell 或者 CMD，敲一句：
node -v
如果输出了一个版本号（比如 v20.11.0），说明装好了。
macOS 用户：推荐用 Homebrew 装，命令行敲：
brew install node
没有 Homebrew 的话，也可以直接去官网下 pkg 安装包。
Linux 用户：以 Ubuntu 为例：
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash - sudo apt-get install -y nodejs
装完同样用 node -v 检查一下版本号。
2. 安装 Claude Code 客户端
Node.js 装好之后，安装 Claude Code 就是一行命令的事。为了避免国内 npm 源拉取慢的问题，建议直接用 npmmirror 镜像：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
等进度条跑完，敲一下：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
能输出版本号就说明 Claude Code 客户端已经装好了。注意先别急着 claude 启动——这时候直接启动它会要求你登录 Anthropic 账号，而我们待会儿要用 Kimi 接入，根本不需要登录官方账号。
三、Kimi API 购买与获取（重头戏）
接下来是这篇教程最核心的部分：拿到 Kimi 的 API Key 并完成充值。
1. 注册 Moonshot 开放平台账号
打开浏览器访问 Kimi 的开放平台：https://platform.moonshot.cn。点右上角注册/登录，用手机号收个验证码就行，整个过程不到一分钟。
新注册的账号一般会赠送 15 元的试用额度，可以先用这点额度跑通流程。
2. 创建 API Key
登录之后，左侧菜单找到 "API Key 管理" （有的版本叫 "API Keys"），点进去。
编辑页面右上角有一个"新建 API Key"的按钮，点击之后会让你填两个东西：一个是 Key 的名字（随便起，比如
claude-code 方便日后辨认），一个是项目（默认选 default 就行）。
确认创建之后，平台会只显示一次完整的 Key，格式是 sk- 开头的一长串字符。这一步一定要立刻复制下来存到本地的备忘录里，关掉页面就再也看不到了，只能重新生成。
四、把 Kimi 接入 Claude Code（最关键的一步）
API Key 拿到了，接下来就是把它配进 Claude Code。原理很简单：Claude Code 通过两个环境变量决定"我去哪里请求模型"和"用什么 Key 请求"，我们只要把这两个变量改成 Kimi 的地址和 Key，它就会乖乖去调 Kimi。
开放平台是有详细的教程的。
编辑
验证一下接入是否成功
随便找一个项目目录，进入终端，敲 claude 启动。看到熟悉的对话框之后，可以输入一句简单的需求测试一下：帮我写一个 Python 脚本，读取当前目录下所有的 .txt 文件，统计每个文件的行数和字符数，最后按行数从多到少排序输出。
如果它能正常吐代码、正常调用文件读写工具、正常给出结果，那就说明整套配置已经跑通了。恭喜你，至此 Claude Code 已经成功接入 Kimi K2.5，可以放心大胆地用了。
五、几个常见的踩坑点
实测下来，新手最容易卡住的几个地方，我提前给你列出来：
第一个坑：报错 401 Unauthorized。 这种情况 99% 是 API Key 没填对，要么是中间多了空格，要么是把 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 搞混了。
Kimi 的 Anthropic 兼容端点用的是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY，这一点一定要看清楚。
第二个坑：报错 429 Too Many Requests。
这是触发了速率限制，前面也提过——免费账号 RPM 只有 3，根本不够用。解决办法只有一个：去充 50 块钱升到 Tier 1。
第三个坑：base_url 末尾要不要加斜杠。
实测下来加不加都能跑，但为了避免某些版本的边界 bug，建议统一写成 https://api.moonshot.cn/anthropic，不加结尾斜杠。
第四个坑：Windows 用户找不到 .claude 文件夹。
因为这是隐藏文件夹，需要在文件资源管理器的"查看"选项里勾上"显示隐藏的项目"才能看到。或者直接在地址栏输入 %USERPROFILE%.claude 回车跳转。
第五个坑：明明配置好了，启动 claude 还是要登录 Anthropic 账号。
这种情况是因为你之前装好 Claude Code 之后跑过一次 claude 命令，它在 ~/.claude.json（注意是文件不是文件夹）里写了一些初始化状态。解决办法是手动编辑这个 json 文件，把 "hasCompletedOnboarding" 这一项设成 true，再重启就不会再要求登录了。
六、订阅Claude会员
讲完 Kimi 方案之后，再补充一下官方订阅的路子。这种方案适合身在海外、有干净住宅网络环境、预算充足的用户，体验上肯定是天花板，毕竟用的是原生的 Claude Opus 4.6 和 Sonnet 4.6，模型能力目前确实比所有国产模型强一截。
国内最大的问题就是支付问题，所以我建议大家尽量使用封号退款的订阅方式，比如礼品卡、Google Play和wildAI。
编辑
可能还有人不了解wildAi的退款机制，这里简单讲一下，就是如果Claude封号退款了，它会把你75%的都给你，当然需要你去找客服解决。
必须提醒的风险
最近几个月 Anthropic 的封号策略非常激进，很多人花了钱订阅 Pro 之后，没用几天号就没了，申诉基本没用。 所以走这条路之前，请务必做好两件事：一是用尽可能干净的网络，
如果你不愿意承担这个风险，那还是老老实实回到本文前半段，用 Kimi 方案或者是使用Deepseek以及智慧谱都可以
写在最后
最后多说一句：Claude Code 这类 agent 式编程工具的真正威力，不是替你写几行代码那么简单，而是让你用对话的方式驱动整个开发流程。
你只需要描述需求，它去读代码、改文件、跑测试、提 PR，你做的事情从"敲键盘"变成了"做产品决策"。这个工作方式的转变，比任何工具本身都更值得你去花时间适应。
如果这篇教程帮到了你，欢迎点赞收藏，方便日后查阅。配置过程遇到任何坑，也欢迎在评论区留言，我看到都会回。
