Claude Code 配置教程

更新日期：2026-06-06

Claude Code 是目前最值得优先接入 Crazyrouter 的终端编码工具之一。它直接使用 Anthropic Messages API，适合代码阅读、修改、重构、命令执行、工具调用和长上下文仓库分析。

概览

通过环境变量，Claude Code 可以把 Anthropic 请求直接发到 Crazyrouter：

推荐协议：Anthropic Messages API
Base URL：https://api.crazyrouter.com
默认国际 API Base URL：https://api.crazyrouter.com
认证变量：ANTHROPIC_API_KEY
推荐默认模型：claude-opus-4-8

Claude Code 自己会补完整的 Anthropic 请求路径，所以 Base URL 必须写根域名 https://api.crazyrouter.com 或 https://api.crazyrouter.com，不要手动拼 /v1 或 /v1/messages。

查看 Claude Code 一键配置仓库

如果你想直接使用脚本安装 Claude Code 并写入 Crazyrouter 环境变量，可以查看 crazyrouter-claude-code 仓库。

适合谁用

想把 Crazyrouter 作为 Claude Code 后端的开发者
想稳定使用工具调用、长上下文和终端编码工作流的人
想把 Claude Code 和 Cursor / Codex / Aider 分开计费的人
想在 Linux、macOS、Windows 上统一配置 CLI 的团队

使用协议

推荐协议：Anthropic Messages API Claude Code 对接 Crazyrouter 时请使用：

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

默认国际 API 入口同样只填写根地址：

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

不要写成：

https://api.crazyrouter.com/v1
https://api.crazyrouter.com/v1/messages
https://api.crazyrouter.com/v1/complete
https://api.crazyrouter.com/v1
https://api.crazyrouter.com/v1/messages

系统要求与前置条件

项目	说明
Crazyrouter 账号	先在 crazyrouter.com 注册
Crazyrouter token	建议单独创建一个给 Claude Code 使用的 `sk-...` token
Git	建议 `git 2.23+`，便于回滚和审查 AI 改动
Node.js	建议 `Node.js 18+`
Claude Code	建议当前稳定版
Claude 系列模型权限	至少放行 `claude-opus-4-8`

建议初始白名单：

claude-opus-4-8
claude-opus-4-8

按操作系统的完整安装路径

Windows 推荐路径

Claude Code 在 Windows 上最稳妥的路径是：Git + Node.js + npm 全局安装 Claude Code + PowerShell 写入环境变量。推荐顺序：

安装 Git
安装 Node.js LTS
使用 npm 安装 Claude Code
用 PowerShell 写临时变量
用 PowerShell 写用户级持久变量

推荐验证命令：

git --version
node -v
npm -v
claude --version
where.exe git
where.exe node
where.exe claude

如果 claude --version 找不到命令，先关闭并重新打开 PowerShell，再重试。

macOS 推荐路径

Claude Code 在 macOS 上最顺手的路径通常是：Xcode Command Line Tools + Homebrew + Git + Node.js + npm 全局安装 Claude Code + ~/.zshrc 持久化环境变量。推荐顺序：

安装 Xcode Command Line Tools
安装 Homebrew（如果你还没有）
安装 Git、Node.js
使用 npm 安装 Claude Code
写入 ~/.zshrc
新开终端验证命令路径

推荐验证命令：

git --version
node -v
npm -v
claude --version
which git
which node
which claude

为什么这里不建议手动写 API 路径

Claude Code 走的是 Anthropic 原生协议。你只需要告诉它站点根地址：

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

默认国际 API 入口同样只填写根地址：

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

不要像 OpenAI 兼容客户端那样自己拼 /v1、/v1/messages 或具体 API 路径。如果你想用脚本自动安装 Claude Code 并写入 Crazyrouter 相关环境变量，可以查看 crazyrouter-claude-code。该仓库提供 Windows、macOS 和 Linux 的一键配置脚本；本文档仍保留完整手动配置步骤，便于你审查每一项配置。

从零开始完整安装

第 1 步：安装 Git

如果你的机器还没有 Git，先装 Git，再继续后面的 Claude Code 配置。

Windows PowerShell
macOS
Ubuntu / Debian

winget install --id Git.Git -e --source winget
git --version

xcode-select --install
git --version

如果你已经使用 Homebrew，也可以：

brew install git
git --version

sudo apt update
sudo apt install -y git
git --version

安装后建议补上全局身份信息：

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

第 2 步：安装 Node.js 18+

Claude Code 依赖 Node.js。先确认版本，再继续安装 Claude Code。

Windows PowerShell
macOS
Ubuntu / Debian

winget install OpenJS.NodeJS.LTS
node -v
npm -v

brew install node
node -v
npm -v

sudo apt update
sudo apt install -y nodejs npm
node -v
npm -v

如果你装完后 node -v 仍低于 18，建议改用 nvm 或 Node 官方安装包升级后再继续。

第 3 步：安装 Claude Code

Windows PowerShell
macOS

npm install -g @anthropic-ai/claude-code
claude --version
where.exe claude

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

不要使用 sudo npm install -g @anthropic-ai/claude-code。如果全局安装遇到权限问题，先修复 npm/Node 环境，再继续安装。

第 4 步：在 Crazyrouter 创建 Claude Code 专用 token

claude-opus-4-8
claude-opus-4-8

同时建议给它设置独立额度，避免和 Cursor、Codex、OpenClaw 共用预算。

第 5 步：先在当前终端设置临时环境变量

先做临时配置，确认能跑通后，再写入持久配置。

macOS / Linux
Windows PowerShell

export ANTHROPIC_BASE_URL=https://api.crazyrouter.com
export ANTHROPIC_API_KEY=sk-xxx
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

$env:ANTHROPIC_BASE_URL = "https://api.crazyrouter.com"
$env:ANTHROPIC_API_KEY = "sk-xxx"
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

把 ANTHROPIC_BASE_URL 写成根域名 https://api.crazyrouter.com，不要写成 https://api.crazyrouter.com/v1。

第 6 步：把环境变量写入持久配置

临时变量只对当前终端有效。日常使用建议写入 shell 配置文件。

Linux Bash
macOS / Zsh
Windows PowerShell

echo 'export ANTHROPIC_BASE_URL=https://api.crazyrouter.com' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=sk-xxx' >> ~/.bashrc
source ~/.bashrc

echo 'export ANTHROPIC_BASE_URL=https://api.crazyrouter.com' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-xxx' >> ~/.zshrc
source ~/.zshrc

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.crazyrouter.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxx", "User")

$env:ANTHROPIC_BASE_URL = "https://api.crazyrouter.com"
$env:ANTHROPIC_API_KEY = "sk-xxx"

持久变量中的 ANTHROPIC_BASE_URL 也应写成 https://api.crazyrouter.com。完成后建议新开一个终端，再执行：

macOS / Linux
Windows PowerShell

claude --version
echo $ANTHROPIC_BASE_URL

claude --version
echo $env:ANTHROPIC_BASE_URL

第 7 步：准备你的 Git 仓库

Claude Code 会读写文件、执行命令。第一次接入时，建议先在你熟悉的小仓库中验证。如果当前目录还不是 Git 仓库：

git init
git add .
git commit -m "chore: initial snapshot before Claude Code"

如果已经是现有仓库，至少先确认工作区是你自己能接受的状态：

git status

第 8 步：启动 Claude Code 并完成第一次验证

进入项目目录后运行：

cd /path/to/your/project
claude

第一次验证建议按下面顺序进行：

先发一句：请只回复 OK
再发一句：只读取当前仓库结构，不要修改任何文件
最后再做低风险任务，例如：请找出 README 里的明显错别字，先不要直接改文件

当这三步都正常返回，且 Crazyrouter 后台出现请求日志，就说明链路已经跑通。

使用场景	推荐模型	原因
默认主力	`claude-opus-4-8`	质量、速度、成本平衡最好，适合大多数编码任务
高难度重构	`claude-opus-4-8`	更强的复杂推理、规划和代码理解
长上下文仓库分析	`claude-opus-4-8`	稳定，适合长期会话
成本敏感验证	`claude-opus-4-8`	先把主链路跑通最重要

在 Claude Code 中使用非 Claude 模型

除了原生 Claude 系列以外，Crazyrouter 也提供了一部分国产模型的 Anthropic Messages 原生接入。下面这份名单只保留 2026-05-15 生产真实客户端复测 已验证通过的模型，不再混入未复测的历史型号。

实测可用模型清单

模型 ID	提供方	`Reply only OK`	读取 `agent.md`	当前结论	备注
`deepseek-v4-pro`	DeepSeek	通过	通过	Claude Code P0 可用	适合通用编码；Codex 侧当前仍不推荐走 Responses
`MiniMax-M2.7`	MiniMax	通过，但含 `<think>`	通过，但含 `<think>`	协议可用	严格输出任务体验差
`kimi-k2.5`	Moonshot Kimi	通过	通过	Claude Code P0 可用	当前是最稳的国产模型候选之一
`kimi-k2.6`	Moonshot Kimi	通过	通过	Claude Code P0 可用	与 `kimi-k2.5` 同档
`glm-5.1`	GLM	通过	通过	Claude Code P0 可用	仅限 Claude Code；Codex 原生 Responses 当前不通过

上述测试基于 Claude Code 真实客户端，经 https://api.crazyrouter.com 根域名走原生 POST /v1/messages 链路验证。

这张表的口径是“当前已复测可用”，不是“所有理论上可转 Anthropic 协议的第三方模型总表”。如果某个型号没出现在这里，代表当前中文文档没有把它列为 Claude Code 的已验证推荐项。

切换模型的方式

Claude Code 通过 ANTHROPIC_MODEL 环境变量或会话内 /model 命令选择模型。把模型名替换成上表中任意一个即可。

macOS / Linux
Windows PowerShell

export ANTHROPIC_BASE_URL=https://api.crazyrouter.com
export ANTHROPIC_API_KEY=sk-xxx

# 临时切到 Kimi K2.5
export ANTHROPIC_MODEL=kimi-k2.5
claude

# 或临时切到 MiniMax
ANTHROPIC_MODEL=MiniMax-M2.7 claude

$env:ANTHROPIC_BASE_URL = "https://api.crazyrouter.com"
$env:ANTHROPIC_API_KEY  = "sk-xxx"

$env:ANTHROPIC_MODEL = "kimi-k2.5"
claude

# 或临时切换
$env:ANTHROPIC_MODEL = "MiniMax-M2.7"; claude

也可以在 Claude Code 启动后通过会话命令切换：

/model kimi-k2.5
/model MiniMax-M2.7

使用建议与已知差异

首选顺序：如果你想在 Claude Code 里优先用国产模型，当前建议从 kimi-k2.5、kimi-k2.6 开始，再考虑 deepseek-v4-pro。Qwen 系列请先通过 /v1/models 确认可用模型 ID，再单独验证。
MiniMax 已知差异：MiniMax-M2.7 虽然协议可用，但会把思考过程作为普通文本直接输出，前后带 <think>...</think> 标签。对“只输出某一句话”这类严格任务，不建议优先选它。
DeepSeek / GLM 的边界：deepseek-v4-pro 和 glm-5.1 在 Claude Code 里可用，不代表它们也适合直接拿去做 Codex 的原生 Responses 配置。这两条链路是两套协议，不要混用兼容结论。
Token 白名单：如果你的 Claude Code 专用 token 开了模型白名单，需要把想用的国产模型一起加入，否则会返回 403 model not allowed。
建议先做真实客户端验证：先跑一轮 Reply only OK，再跑“读取一个文件并只返回标题”的任务，比只测裸 API 更接近 Claude Code 真实使用场景。

一条命令快速验证某个模型是否可用

curl -sS https://api.crazyrouter.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.5",
    "max_tokens": 32,
    "messages": [{"role":"user","content":"reply OK"}]
  }'

返回 200 且 content[].text 不为空即代表 Claude Code 可以正常使用该模型。

Token 设置最佳实践

设置	建议	说明
专用 token	必须	Claude Code 不要和 Cursor、Codex、OpenClaw 共用 token
模型白名单	强烈建议	只放行当前实际要用的 Claude 或国产模型，减少排障和控费复杂度
IP 限制	固定出口环境建议开启	笔记本经常变 IP 时谨慎使用
配额上限	强烈建议	Claude Code 长会话 + 工具调用容易持续消耗额度
开发 / 团队分离	建议	每个开发者、每台共享主机都单独使用 token
泄露轮换	必须	shell 历史、录屏或共享终端暴露 token 后立即轮换

验证清单

常见错误与修复

现象	常见原因	修复方式
`claude: command not found`	Claude Code 没装成功，或 npm 全局路径没进 PATH	重新安装，确认 `npm bin -g` 所在目录已进 PATH
`node` 版本过低	本机 Node 版本低于要求	升级到 Node.js 18+ 后重装 Claude Code
401 unauthorized	`ANTHROPIC_API_KEY` 无效、过期或复制错误	重新生成 token 并重新设置环境变量
403 / model not allowed	token 没有放行当前 Claude 模型	在 Crazyrouter token 设置中放行所需模型
404	Base URL 写成 `/v1`、`/v1/messages` 等错误路径	改回 `https://api.crazyrouter.com` 或 `https://api.crazyrouter.com`
日志路径出现 `/v1/v1/messages`、`/v1/v1/models` 或 `/v1/messages/v1/messages`	Claude Code 的 Base URL 中误带了 `/v1` 或完整端点，客户端又自动追加了一次路径	把 `ANTHROPIC_BASE_URL` 改成根域名，不要带任何路径
Claude Code 启动后仍走旧配置	新环境变量没有重新加载	新开终端，或重新 `source ~/.bashrc` / `source ~/.zshrc`
Git 改动太乱	没先做仓库快照就开始让 AI 改代码	先提交初始快照，再逐轮修改
成本超预期	长上下文 + 多轮工具调用 + 长时间会话	缩短会话、拆分任务、给 Claude Code 单独设预算

性能与成本建议

默认先用 claude-opus-4-8
只有在复杂架构分析、长链路重构时再切 claude-opus-4-8
第一次接入先用小仓库验证，不要直接对大型生产仓库全量操作
每次进入新任务前先看一下 git status
工具调用频繁时，更要回看 Crazyrouter 日志和 token 消耗

FAQ

Claude Code 里 Base URL 应该写什么？

写根域名：https://api.crazyrouter.com 默认国际 API 入口写根域名：https://api.crazyrouter.com

为什么这里不能写 `/v1`？

因为 Claude Code 自己会补 Anthropic Messages API 路径。你只需要提供站点根地址。

我在 Windows 上应该用什么方式？

如果你主要是命令行开发，优先用 PowerShell 或 WSL2。无论哪种方式，都先保证 Git、Node.js、Claude Code 自己都已正确安装。

Windows 上推荐用 PowerShell 还是 Git Bash？

首次配置时优先用 PowerShell。环境变量写入、where.exe 验证和用户级变量持久化都更直接。

第一次为什么要先做 Git 快照？

因为 Claude Code 会改文件、跑命令。先做快照，出问题时你更容易 review 和回退。

第一个推荐模型是什么？

先用 claude-opus-4-8。它通常是最稳的基线模型。

如果你优先追求 Claude 系列模型 + 终端编码体验，Claude Code 应该放在 Crazyrouter 编码工具接入顺序的最前面。

查看 crazyrouter-claude-code 仓库

查看一键配置脚本、README 和最新使用说明。

API Key & 控制台管理

SDK & 代码示例

第三方集成

Claude Code 配置教程

概览

查看 Claude Code 一键配置仓库

适合谁用

使用协议

系统要求与前置条件

按操作系统的完整安装路径

Windows 推荐路径

macOS 推荐路径

为什么这里不建议手动写 API 路径

从零开始完整安装

推荐模型配置

在 Claude Code 中使用非 Claude 模型

实测可用模型清单

切换模型的方式

使用建议与已知差异

一条命令快速验证某个模型是否可用

Token 设置最佳实践

验证清单

常见错误与修复

性能与成本建议

FAQ

Claude Code 里 Base URL 应该写什么？

为什么这里不能写 `/v1`？

我在 Windows 上应该用什么方式？

Windows 上推荐用 PowerShell 还是 Git Bash？

第一次为什么要先做 Git 快照？

第一个推荐模型是什么？

查看 crazyrouter-claude-code 仓库

​概览

查看 Claude Code 一键配置仓库

​适合谁用

​使用协议

​系统要求与前置条件

​按操作系统的完整安装路径

​Windows 推荐路径

​macOS 推荐路径

​为什么这里不建议手动写 API 路径

​从零开始完整安装

​推荐模型配置

​在 Claude Code 中使用非 Claude 模型

​实测可用模型清单

​切换模型的方式

​使用建议与已知差异

​一条命令快速验证某个模型是否可用

​Token 设置最佳实践

​验证清单

​常见错误与修复

​性能与成本建议

​FAQ

​Claude Code 里 Base URL 应该写什么？

​为什么这里不能写 /v1？

​我在 Windows 上应该用什么方式？

​Windows 上推荐用 PowerShell 还是 Git Bash？

​第一次为什么要先做 Git 快照？

​第一个推荐模型是什么？

查看 crazyrouter-claude-code 仓库

概览

适合谁用

使用协议

系统要求与前置条件

按操作系统的完整安装路径

Windows 推荐路径

macOS 推荐路径

为什么这里不建议手动写 API 路径

从零开始完整安装

推荐模型配置

在 Claude Code 中使用非 Claude 模型

实测可用模型清单

切换模型的方式

使用建议与已知差异

一条命令快速验证某个模型是否可用

Token 设置最佳实践

验证清单

常见错误与修复

性能与成本建议

FAQ

Claude Code 里 Base URL 应该写什么？

为什么这里不能写 `/v1`？

我在 Windows 上应该用什么方式？

Windows 上推荐用 PowerShell 还是 Git Bash？

第一次为什么要先做 Git 快照？

第一个推荐模型是什么？