Claude Code 配置教程

在 Claude Code 中通过 Anthropic Messages API 接入 Crazyrouter，并提供从 Git、Node.js、安装命令、环境变量到首次验证的完整步骤

更新日期：2026-06-06

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

概览

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

推荐协议：Anthropic Messages API

Base URL：https://api.crazyrouter.com

中国大陆优化 / 长请求备用 Base URL：https://cn.crazyrouter.com

认证变量：ANTHROPIC_API_KEY

推荐默认模型：claude-opus-4-8

Tip: Claude Code 自己会补完整的 Anthropic 请求路径，所以 Base URL 必须写根域名 https://api.crazyrouter.com（中国大陆可用 https://cn.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

中国大陆需要走优化线路时请使用：

ANTHROPIC_BASE_URL=https://cn.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

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

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

新开终端验证命令路径

推荐验证命令：

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

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

ANTHROPIC_BASE_URL=https://api.crazyrouter.com

中国大陆优化线路同样只填写根地址：

ANTHROPIC_BASE_URL=https://cn.crazyrouter.com

不要像 OpenAI 兼容客户端那样自己拼 /v1、/v1/messages 或具体 API 路径。

如果你想用脚本自动安装 Claude Code 并写入 Crazyrouter 相关环境变量，可以查看 crazyrouter-claude-code。该仓库提供 Windows、macOS 和 Linux 的一键配置脚本；本文档仍保留完整手动配置步骤，便于你审查每一项配置。

从零开始完整安装

第 1 步：安装 Git

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

Windows PowerShell

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

macOS

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

Ubuntu / Debian

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

第 2 步：安装 Node.js 18+

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

Windows PowerShell

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

macOS

Ubuntu / Debian

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

第 3 步：安装 Claude Code

Windows PowerShell

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

macOS

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

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

第一次只建议放行：

claude-opus-4-8

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

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

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

macOS / Linux

Windows PowerShell

        $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://cn.crazyrouter.com，不要改成 https://api.crazyrouter.com/v1。

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

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

Linux Bash

macOS / Zsh

Windows PowerShell

        [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://cn.crazyrouter.com。

完成后建议新开一个终端，再执行：

macOS / Linux

Windows PowerShell

        claude --version
        echo $env:ANTHROPIC_BASE_URL

第 7 步：准备你的 Git 仓库

Claude Code 会读写文件、执行命令。第一次接入时，建议先在你熟悉的小仓库中验证。

如果当前目录还不是 Git 仓库：

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

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

进入项目目录后运行：

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

先发一句：请只回复 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 链路验证。

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

切换模型的方式

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

macOS / Linux

Windows PowerShell

    $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 真实使用场景。

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

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

Token 设置最佳实践

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

验证清单

git --version 正常

node -v 不低于 18

claude --version 正常

ANTHROPIC_BASE_URL 已设置为 https://api.crazyrouter.com（中国大陆可用 https://cn.crazyrouter.com）

ANTHROPIC_API_KEY 已正确设置

Claude Code 可以正常启动

第一条普通文本请求成功返回

只读仓库分析可以正常工作

Crazyrouter 后台日志中能看到 Claude Code 请求

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://cn.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

中国大陆优化线路写根域名：https://cn.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。它通常是最稳的基线模型。

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

查看 crazyrouter-claude-code 仓库

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

最后校验/修改：2026-09-28（API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com，共 23 处；账号/控制台仍为 https://crazyrouter.com）

Claude Code 安装使用教程

Claude Code 配置教程#

概览#

适合谁用#

使用协议#

系统要求与前置条件#

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

Windows 推荐路径#

macOS 推荐路径#

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

从零开始完整安装#

第 1 步：安装 Git#

Windows PowerShell#

macOS#

Ubuntu / Debian#

第 2 步：安装 Node.js 18+#

Windows PowerShell#

macOS#

Ubuntu / Debian#

第 3 步：安装 Claude Code#

Windows PowerShell#

macOS#

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

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

macOS / Linux#

Windows PowerShell#

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

Linux Bash#

macOS / Zsh#

Windows PowerShell#

macOS / Linux#

Windows PowerShell#

第 7 步：准备你的 Git 仓库#

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

推荐模型配置#

在 Claude Code 中使用非 Claude 模型#

实测可用模型清单#

切换模型的方式#

macOS / Linux#

Windows PowerShell#

使用建议与已知差异#

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

Token 设置最佳实践#

验证清单#

常见错误与修复#

性能与成本建议#

FAQ#

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

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

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

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

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

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

Claude Code 配置教程

概览

适合谁用

使用协议

系统要求与前置条件

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

Windows 推荐路径

macOS 推荐路径

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

从零开始完整安装

第 1 步：安装 Git

Windows PowerShell

macOS

Ubuntu / Debian

第 2 步：安装 Node.js 18+

Windows PowerShell

macOS

Ubuntu / Debian

第 3 步：安装 Claude Code

Windows PowerShell

macOS

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

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

macOS / Linux

Windows PowerShell

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

Linux Bash

macOS / Zsh

Windows PowerShell

macOS / Linux

Windows PowerShell

第 7 步：准备你的 Git 仓库

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

推荐模型配置

在 Claude Code 中使用非 Claude 模型

实测可用模型清单

切换模型的方式

macOS / Linux

Windows PowerShell

使用建议与已知差异

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

Token 设置最佳实践

验证清单

常见错误与修复

性能与成本建议

FAQ

Claude Code 里 Base URL 应该写什么？

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

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

Windows 上推荐用 PowerShell 还是 Git Bash？

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

第一个推荐模型是什么？