说实话，Zui近这阵风刮得真猛。Ru果你还在用传统的 Copilot 或者仅仅依赖网页版的 ChatGPT 写代码，那你可Neng真的有点“out”了。Anthropic 推出的 Claude Code 简直就是为了咱们这些整天泡在终端里的开发者量身定Zuo的。它不仅仅是个聊天机器人，它是一个Neng真正读懂你整个项目上下文、Neng直接在命令行里帮你改代码、跑测试、甚至帮你生成 Git 提交信息的“全Neng副驾驶”。

但是问题来了。官方的 API 门槛不低，而且在国内网络环境下直连 Anthropic 的服务简直像是在开盲盒——全kan运气。再加上那让人肉疼的按量计费，对于咱们个人开发者或者初创小团队来说成本压力确实不小。别急，今天这篇文章就是来给你“雪中送炭”的。我们要聊的，是如何通过神马中转 API，用极低的成本，甚至接近白嫖的体验，把 Claude Code 安装到你的本地环境里让它乖乖为你干活。

这不仅仅是一篇教程，geng像是一份避坑指南。我会手把手带你从环境搭建到配置完成，哪怕你是第一次接触命令行工具的小白，也Neng跟着跑通。准备好了吗？咱们开始折腾吧。

第一步：磨刀不误砍柴工——检查 Node.js 环境

在召唤 Claude Code 这个神兽之前，你得先给它搭个窝。Claude Code 是基于 Node.js 构建的，所以你的电脑里必须得有 Node.js 环境。别嫌我啰嗦，hen多人第一步就卡在这里结果后面全是报错，心态崩了。

打开你的终端，输入以下命令kankan你的版本：

node --version
npm --version

这里有个硬性指标：Node.js 的版本Zui好在 v18.x.x 以上。文档里虽然写着至少需要 11.4.2 版本的 npm，但为了兼容性和性Neng，我强烈建议你直接上Zui新的 LTS 版本，比如 v20 或者 v22。Ru果你输完命令kan到版本号低于 v18，或者干脆提示“command not found”，那你得先去 Node.js 官网下载个Zui新版安装包，或者用 nvm、brew 这种包管理工具升级一下。

Ru果你是 Linux 用户，这几行命令或许Neng帮你省点事：

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
# 检查是否安装成功
npm -v
node -v

确认环境没问题后咱们就Ke以进入正题了。记住环境这一步没走好，后面全是泪。

第二步：一键安装 Claude Code

有了 Node.js，安装 Claude Code 就简单得像去楼下便利店买瓶水一样。npm 的全局安装命令Neng帮我们搞定一切依赖。

在你的终端里敲下这行指令：

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

这里解释一下`-g` 参数代表 global，这意味着你Ke以在电脑的任何目录下直接调用 `claude` 命令，而不需要每次dou跑到安装文件夹里去找它。安装过程可Neng需要几分钟，取决于你的网速，耐心等它跑完就是了。

装完之后别急着兴奋，先验证一下：

claude --version

Ru果屏幕上乖乖吐出了版本号，比如 `Claude Code v1.0.0` 之类的，恭喜你，安装阶段圆满结束！但这只是万里长征走完了第一步，接下来才是重头戏——配置。

第三步：核心机密——配置环境变量与中转站

为什么hen多人说 Claude Code 好用但难用？因为默认情况下它是直连 Anthropic 官方 API 的。在国内，这基本等于“连不上”或者“慢得像蜗牛”。而且，官方 API 的 Key 也就是那个 `sk-xxx` 开头的字符串，搞起来也挺麻烦。

这时候，API 中转站的价值就体现出来了。我们这里以“神马中转 API”为例，它的核心作用就是：把你发出的请求，通过一条高速、稳定的通道，转发给 Claude 的模型，然后再把结果传回来。对你来说你只需要配置两个东西，就Neng完美“欺骗”Claude Code，让它以为自己在连官方服务器。

这两个关键的环境变量就是：

ANTHROPIC_AUTH_TOKEN你在神马平台生成的 Token。

ANTHROPIC_BASE_URL中转站的地址，这里我们用 `https://api.whatai.cc` 作为示例。

下面我们分操作系统来具体讲讲怎么设置这两个变量。千万别跳过这一段，不同系统的设置方法天差地别。

macOS 与 Linux 用户：配置 .zshrc 或 .bash_profile

Ru果你用的是 macOS或者 Linux，默认 shell 大概率是 Zsh。我们需要把配置写进 `~/.zshrc` 文件里。这样每次你打开终端，这些变量就会自动加载。

直接在终端复制粘贴下面这几行命令：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"'>> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.whatai.cc"'>> ~/.zshrc
source ~/.zshrc

注意kan，上面的 `sk-xxx` 只是个占位符！一定要把它替换成你在神马中转后台复制的真实 Token，不然你连dou连不上。Zui后一行 `source` 命令是为了让配置立即生效，不用重启终端。

Ru果你还在用老派的 Bash，那就把 `~/.zshrc` 换成 `~/.bash_profile`，操作逻辑是一样的：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"'>> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.whatai.cc"'>> ~/.bash_profile
source ~/.bash_profile

Windows 用户：PowerShell 与 settings.json 的双重选择

Windows 用户可Neng稍微麻烦一点点，但也不难。我们有几种方法，你Ke以挑自己喜欢的来。

方法一：PowerShell

打开 PowerShell，输入以下命令。这里使用 `.NET` 的方法来设置用户级环境变量，重启电脑后依然有效：

::SetEnvironmentVariable
::SetEnvironmentVariable

或者，Ru果你喜欢用 CMD 风格的命令，也Ke以试试 `setx`：

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.whatai.cc"

方法二：图形化界面

Ru果你不信任命令行，那就用Zui原始的方法。右键“此电脑”->“属性”->“高级系统设置”->“环境变量”。在“用户变量”里新建两个变量，名和值对应填进去就行。这种方法虽然笨一点，但胜在直观，不容易出错。

Windows 进阶技巧：用 settings.json 一次性写入

这是我个人比较推荐的方式，特别是当你需要指定特定模型的时候。Claude Code 会读取用户目录下的配置文件。路径通常是：

C:\Users\{你的用户名}\.claude\settings.json

你Ke以手动创建这个文件，然后把下面的 JSON 结构贴进去。记得把 Token 换成你自己的：

{
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_BASE_URL": "https://api.whatai.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx"
  }
}

这样配置的好处是你甚至Ke以在文件里指定默认用哪个模型，不用每次dou在命令行里切来切去。

特别提醒： 无论你用哪种系统，改完环境变量后一定要重启终端！不重启的话，新的变量是读不到的，你会一直报错，然后开始怀疑人生。

第四步：启动！让 AI 进入你的项目

配置dou搞定了现在是见证奇迹的时刻。Claude Code Zui大的优势就是“上下文感知”。它不是瞎猜你的代码在干嘛，而是真的会去读你的文件。

所以请务必先进入你的项目目录。比如：

cd your-project-folder
claude

当你输入 `claude` 并回车后你会kan到终端界面发生了一些变化，通常会出现一个欢迎界面或者让你Zuo一些初始化的选择。跟着提示走就行，一般选默认的就没错。

一旦进入交互模式，你就Ke以像跟一个坐在你旁边的资深程序员聊天一样，给它下指令了。

第五步：实战技巧与模型切换

进了门，咱们得知道怎么玩才爽。Claude Code 支持hen多内置命令，这些命令Neng极大提升你的效率。

自然语言交互

你不需要背诵复杂的提示词，直接说人话。比如：

claude "请帮我写一个Python函数，用于计算斐波那契数列"

或者，让它帮你检查代码里的 Bug：

claude "review this code for potential bugs"

它就会扫描你当前目录下的文件，结合上下文给出非常详细的建议。

内置命令速查

在交互模式下有些以 `/` 开头的命令是神器：

/help忘了怎么用？输入这个查kan所有内置命令。

/clear聊嗨了上下文太长？清空一下重新开始。

/review快速进行代码审查，这比你自己一行行kan快多了。

/model 这是低成本玩转的关键！

灵活切换模型

神马中转 API 的好处之一就是支持多种模型。默认情况下Claude Code 可Neng会调用 Sonnet。但Ru果你需要geng强的推理Neng力，或者想试试别的模型，直接用 `/model` 命令切。

比如想切到 Opus：

/model opus

或者，Ru果你想试试 Kimi 的模型：

/model moonshotai/kimi-k2-instruct

甚至 OpenAI、Gemini、Qwen、Doubao 等各大厂的模型，只要你的中转站支持，douNeng通过这种方式无缝切换。这种灵活性，让你永远Neng用上性价比Zui高的那个模型。

第六步：常见问题与避坑指南

折腾技术嘛，哪有一帆风顺的。这里列几个新手Zui容易踩的坑，希望Neng帮你省点头发。

Q: 配置完了但是一直提示认证失败怎么办？ A: 90% 的概率是 Token 填错了或者 Base URL 拼写错误。再去检查一遍 `sk-xxx` 有没有多空格，URL 是不是 `https` 开头。另外确认一下你的中转站账户里还有没有余额。

Q: Windows 下改了环境变量没反应？ A: 记得把所有打开的终端、VS Code 窗口全部关掉，重新打开。Windows 的环境变量缓存有时候hen顽固。

Q: 怎么让它帮我写 Git 提交信息？ A: hen简单，在交互模式下输入 `claude commit`，它会自动分析你的 `git diff`，然后生成一条规范的 commit message。

Q: Node.js 版本太低怎么办？ A: 别硬撑，升级吧。用 `nvm install node` 装个Zui新的，旧版本兼容性真的hen差，尤其是对于 Claude Code 这种新工具。

让 AI 成为你真正的副驾驶

通过神马中转 API 接入 Claude Code，不仅仅是为了省那几个美元，geng是为了获得一种稳定、高效、不被网络

这不再是科幻小说里的场景，而是现在就Neng触手可及的现实。希望这篇教程Neng帮你顺利搭建起属于自己的 AI 编程环境。别犹豫了赶紧去试试吧，让你的代码效率起飞！

---