单元二和 AI 第一次合作 · 选修 A

换一个助手：Claude Code

选修课，跳过不影响后面的内容。学会一个编程智能体以后，再上手第二个只要二十分钟，还能对比一下两者的风格。

本课目标

安装 Claude Code，并用环境变量接入本站 API。
把它设置成“每次动手前都先问我”。
用它把第 7 课的只读任务再做一遍。

先懂概念：同一把钥匙，不同的助手

Claude Code 是 Anthropic 出品的编程智能体，命令是 claude。它和 Codex 用的是同一套本站 API 和同一个 Key，区别只在于它读取的环境变量名字不同：

环境变量	作用
`ANTHROPIC_BASE_URL`	API 地址，填 `https://api.zairouter.com`
`ANTHROPIC_AUTH_TOKEN`	你的 Key

设置了这两个变量，Claude Code 就直接使用本站 API，不需要登录 Claude 官方账号。

跟着做

1. 安装

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

macOS：

curl -fsSL https://claude.ai/install.sh | bash

装好后重开终端，检查：

claude --version

如果下载失败，可以和第 5 课一样改用 npm 加国内镜像（需要 Node.js 22 或更高版本）：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

2. 设置环境变量

沿用第 6 课已经设好的 XAI_API_KEY，不用再复制一遍 Key。

Windows：

setx ANTHROPIC_BASE_URL "https://api.zairouter.com"
setx ANTHROPIC_AUTH_TOKEN "$env:XAI_API_KEY"

macOS：

echo 'export ANTHROPIC_BASE_URL="https://api.zairouter.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="$XAI_API_KEY"' >> ~/.zshrc

macOS 的第二行用了单引号，写进文件的是 $XAI_API_KEY 这个名字而不是 Key 本身，以后换 Key 只需要按第 6 课的方法改 XAI_API_KEY 原来那一行。Windows 的 setx 会把当前的 Key 复制一份保存，以后换 Key 时，这条命令也要重新运行一次。

设置完重开终端，检查长度：

$env:ANTHROPIC_AUTH_TOKEN.Length

echo ${#ANTHROPIC_AUTH_TOKEN}

3. 让它每次动手前先问你

新版 Claude Code 默认使用“自动模式”：由另一个 AI 替你判断能不能执行，而不是每次都问你；在计划模式里，它默认也会让这个 AI 替你批准调查用的命令。刚开始学，我们改成由你自己审批：内置的只读命令（比如列出文件、读取文件）仍会直接执行，修改文件和运行其他命令之前会先问你。

下面的命令会新建配置文件 settings.json，已有的同名文件会被覆盖。如果你以前用过 Claude Code，先检查这个文件是否存在：Windows 运行 Test-Path "$HOME\.claude\settings.json"，macOS 运行 ls ~/.claude/settings.json。如果已经存在，不要运行下面的命令，而是用记事本或文本编辑打开它，把 permissions 和 useAutoModeDuringPlan 合并进去。

Windows：

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
@'
{
  "permissions": {
    "defaultMode": "default"
  },
  "useAutoModeDuringPlan": false
}
'@ | Set-Content -Encoding ascii "$HOME\.claude\settings.json"

macOS：

mkdir -p ~/.claude
cat > ~/.claude/settings.json <<'EOF'
{
  "permissions": {
    "defaultMode": "default"
  },
  "useAutoModeDuringPlan": false
}
EOF

4. 再做一次第 7 课的任务

为了不打乱已经整理好的练习包，用备份做一份新副本：

Copy-Item -Recurse ~/ai-course/practice-pack-backup ~/ai-course/practice-claude

cp -R ~/ai-course/practice-pack-backup ~/ai-course/practice-claude

然后启动 Claude Code，并直接进入计划模式：它先调查、提方案，不修改文件。计划模式是一种工作方式，不是安全沙箱；按第 3 步设置后，只读命令之外的命令仍要你审批（前提是不要用跳过权限的方式启动）：

cd ~/ai-course/practice-claude
claude --permission-mode plan

第一次启动时，它会让你选界面配色，并询问是否信任这个文件夹，确认即可。然后把第 7 课的任务原样发给它。

你应该看到

屏幕底部显示 ⏸ plan mode on，说明处在计划模式。
它读完文件后给出报告。用第 7 课的标准答案核对，特别是 10 月的报销总额（1553.50 元）。
输入 /status，能看到它使用的 API 地址是本站。

几个常用操作：

操作	作用
`Shift + Tab`	切换模式：计划模式、需要你审批的手动模式（manual）等
`Esc`	打断它正在做的事
`/clear`	开始新对话
`/exit` 或连按两次 `Ctrl + D`	退出

常见问题

还是让我登录 Claude 账号？ 说明它没看到环境变量。确认重开过终端，并用上面的命令检查 ANTHROPIC_AUTH_TOKEN 的长度不是 0。

报 401？ Key 不对。Windows 用户如果后来换过 Key，记得重新运行 setx ANTHROPIC_AUTH_TOKEN 那一行。

底部显示的不是 plan 或 manual，而是 auto？ 说明第 3 步的设置没生效，检查 settings.json 的内容和位置。

想系统了解 Claude Code，请看 Claude 专题。

自检

claude --version 能显示版本号。
Claude Code 通过本站 API 回答了问题，没有要求登录。
我知道怎么用 Shift + Tab 切换模式，知道 auto 模式不适合新手。
我核对过它的答案。

上一课让 AI 动手改文件下一课换一个助手：Grok CLI