Claude Code 接入 · 新手教程

装好 Claude Code，三种写法填上小店的地址和密钥，验证能用。

Claude Code 是在终端里跑的编程助手。它默认连 Anthropic 官方，把两个环境变量改成小店的地址和密钥，就能走小店的额度。全程不需要官方账号。

一、先准备一把 Anthropic 分组的密钥

注册并登录：/register，已有账号去 /login。
买好额度并兑换：没额度调用会直接失败。做法见充值与兑换。
到 API 密钥页点「创建」，分组一定要选 Anthropic 类型，目前有两个：

分组	倍率	适合谁
CC MAX正价分组	1.00×	Claude 系列，与官方同价。想要和官方一样的体验就选它。
Kiro正价	0.14×	同样的调用只扣 14% 的额度，便宜很多。店主建议先小额测试，确认合你用再长期用。

算一笔账：claude-opus-5-5 官方价是每百万 token 输入 $4、输出 $20。一次官方计 $1 的调用，在 CC MAX 扣 $1 额度（1 元），在 Kiro 只扣 $0.14（0.14 元）。各分组的说明见分组怎么选。

密钥明文只在创建成功时显示一次。先复制到记事本存好，关掉弹窗就看不到了，忘了只能重建一把。

二、安装 Claude Code

它通过 npm 安装，所以电脑上要先有 Node.js。没有的话去 nodejs.org 下载安装包，一路下一步。然后打开终端（macOS 用「终端」，Windows 用「PowerShell」），执行：

npm i -g @anthropic-ai/claude-code
claude --version

第二行能打印出版本号，就装好了。

三、填地址和密钥（三种写法）

最省事的办法：回到 API 密钥页，点那把密钥右边的「使用」，弹窗选 Claude Code，再按你的终端选 Terminal / Command Prompt / PowerShell 标签，里面的内容已经替你填好了，直接复制。下面是手工写法，内容和弹窗一致。

三个变量的意思：「ANTHROPIC_BASE_URL」是小店地址；「ANTHROPIC_AUTH_TOKEN」是你的密钥；「CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1」关掉 Claude Code 自己的非必要联网请求，弹窗模板自带，照抄即可。

写法 1：macOS / Linux，写进 ~/.zshrc 或 ~/.bashrc

macOS 默认是 zsh，编辑「~/.zshrc」；多数 Linux 是 bash，编辑「~/.bashrc」。在文件末尾加三行：

export ANTHROPIC_BASE_URL="https://api.zyuou.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

保存后执行「source ~/.zshrc」（或「source ~/.bashrc」），或者直接关掉终端重开。

写法 2：Windows PowerShell

先在当前窗口试一下，这三行只对这个窗口有效，关了就没了：

$env:ANTHROPIC_BASE_URL="https://api.zyuou.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

想永久生效，把同样三行写进 PowerShell 的启动文件「$PROFILE」。先执行下面两行，第一行在文件不存在时创建它，第二行用记事本打开：

if (!(Test-Path $PROFILE)) { New-Item $PROFILE -ItemType File -Force }
notepad $PROFILE

把上面那三行「$env:」粘进去，保存，重开 PowerShell。

用的是「命令提示符」（cmd）而不是 PowerShell？弹窗里 Command Prompt 标签给的是「set ANTHROPIC_BASE_URL=https://api.zyuou.com」这种写法，不带引号，也只对当前窗口有效。

写法 3：~/.claude/settings.json

不想碰环境变量，也可以写进 Claude Code 自己的配置文件。macOS / Linux 在「~/.claude/settings.json」，Windows 在「%USERPROFILE%\.claude\settings.json」。文件不存在就新建，内容如下（已有文件则把 env 这一段合并进去）：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zyuou.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

这种写法不依赖哪种终端，终端里的 Claude Code 和 VS Code 扩展都读它。三种写法选一种就够，别混着填。

四、验证

关掉所有终端窗口，重新打开一个。环境变量只在新窗口里生效。
先确认变量读到了。macOS / Linux 执行「echo $ANTHROPIC_BASE_URL」，PowerShell 执行「$env:ANTHROPIC_BASE_URL」，应打印 https://api.zyuou.com。
进到任意一个项目文件夹，执行「claude」，随便问一句，比如「用一句话介绍你自己」。有正常回复就通了。
再到使用记录页看一眼，应该多了一条 claude 模型的记录，并能看到扣了多少额度。

五、常见坑

同时设了 ANTHROPIC_API_KEY。它和 ANTHROPIC_AUTH_TOKEN 是两套认证方式，两个都在时 Claude Code 可能拿错一把，典型表现是 401「Invalid API key」，或被要求登录官方账号。用「echo $ANTHROPIC_API_KEY」（PowerShell：「$env:ANTHROPIC_API_KEY」）查一下，有值就删掉：macOS / Linux 执行「unset ANTHROPIC_API_KEY」并从 .zshrc / .bashrc 里删掉那行；Windows 执行「Remove-Item Env:ANTHROPIC_API_KEY」，再到「系统 → 高级系统设置 → 环境变量」里确认没有残留。只留 AUTH_TOKEN 一个。
改完没重开终端。旧窗口里还是旧值，重开再试。写进 $PROFILE 或 .zshrc 后也一样要重开。
以前用官方账号登录过。在 Claude Code 里执行「/logout」退出，重开终端再进。
密钥选错了分组。用 OpenAI 分组的密钥跑 Claude 模型，会报 404「Model "claude-…" is not available for this group」，或「is not supported by any configured account in this group」。回密钥页用 Anthropic 分组重建一把。
401「Invalid API key」/「API key is disabled」。密钥复制漏了字、首尾带空格，或这把密钥已被停用。
403「Insufficient account balance」。余额不足，去兑换页充值后立刻可用。
429「Concurrency limit exceeded for user, please retry later」。同时发出的请求太多，等几秒再试。

还是不行？

把终端里的完整报错（带状态码那一行）对照常见报错查一遍。查不到的，加 QQ 群 1104498354，备注「新手」，或直接找客服 QQ 3480261526，把报错截图发过去。