#Claude Code 接入万模API

适用协议：Claude Messages | 适合：命令行 AI 编码、项目级任务和 Claude 协议工具调用

Claude Code 是可以读取项目、执行命令、修改文件的编码工具。它默认面向 Anthropic 官方服务，但也支持通过 LLM gateway 连接 Claude Messages 兼容接口。接入万模API时，关键是让 Claude Code 请求 https://www.wanmoapi.com/v1/messages，并把令牌作为 Anthropic 风格的鉴权信息传入。

这篇教程按“第一次接入编码工具”的顺序写：先确认本地环境，再安装 Claude Code，再选择 CCSwitch 自动配置或手动设置环境变量，最后用只读任务验证请求是否走到万模API。

#你最终要填什么

#安装路线

如果你还不会打开终端，先看：本地环境准备。

#第一步：创建 Claude Code 专用令牌

建议给 Claude Code 单独创建一个令牌，例如 claude-code-dev。

这样做有三个好处：

• 可以单独查看 Claude Code 的调用日志和消耗。
• 出现异常消耗时可以只停用这个令牌。
• 后续可以给 Claude Code 配置独立分组和额度。

如果你还没创建令牌，先看认证与令牌。创建后复制完整 sk-...，不要把完整 Key 写进截图、公开文档或项目仓库。

#第二步：安装 Claude Code

官方推荐优先使用原生安装器。你也可以用 Homebrew、WinGet 或 npm。

#macOS / Linux / WSL

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

验证：

claude --version
claude doctor

#Windows PowerShell

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

验证：

claude --version
claude doctor

#macOS Homebrew

brew install --cask claude-code

#Windows WinGet

winget install Anthropic.ClaudeCode

#npm 安装方式

如果你的团队统一使用 Node/npm，可以先安装 Node.js 18+，再执行：

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

验证：

claude --version

#第三步：选择配置方式

Claude Code 有两种配置方式：

如果你已经安装了 CCSwitch，建议优先走自动配置；它能把 Claude Code provider 和模型切换集中管理，避免你在多个终端里反复修改环境变量。详细安装和截图见：CCSwitch 接入万模API。

#方式一：用 CCSwitch 自动配置 Claude Code

1. 打开 CCSwitch。
2. 在 API Key 列表中选择刚创建的 Claude Code 专用令牌。
3. 添加 provider 时选择 Claude Code。
4. Base URL 填 https://www.wanmoapi.com。
5. 模型选择控制台可用的 Claude Messages 模型。
6. 保存后在 CCSwitch 面板中把该 provider 切换为使用中。

完成后关闭并重新打开终端，再运行：

claude doctor
claude

如果你在 WSL 内运行 Claude Code，需要在 WSL 环境里也完成 CCSwitch 配置或手动设置环境变量。Windows 原生 PowerShell 和 WSL 不共享同一套运行环境。

#方式二：手动设置万模API令牌

#macOS / Linux / WSL

export ANTHROPIC_BASE_URL="https://www.wanmoapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-..."

长期保存到 zsh：

echo 'export ANTHROPIC_BASE_URL="https://www.wanmoapi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.zshrc
source ~/.zshrc

#Windows PowerShell

当前窗口临时生效：

$env:ANTHROPIC_BASE_URL="https://www.wanmoapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."

长期保存：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.wanmoapi.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-...", "User")

重新打开 PowerShell 后验证：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

#第四步：选择模型

Claude Code 的模型选择要满足两个条件：

1. 控制台里这个模型对你的令牌分组可用。
2. 该模型支持 Claude Messages 协议和编码工具需要的上下文能力。

如果启用了 gateway 模型发现，Claude Code 可能会从 /v1/models 读取可用模型。否则可以在 Claude Code 内通过模型选择或命令行参数选择。

编码代理建议优先选择：

• 支持长上下文的模型，用于读取多文件。
• 支持工具调用或函数调用的模型，用于执行编辑任务。
• 响应稳定、延迟可控的模型，用于长时间任务。

如果模型不存在，先在控制台或 /v1/models 确认模型名，再检查令牌分组是否有权限。

#第五步：只读验证

进入一个测试项目目录：

cd your-project
claude

输入：

列出当前项目主要目录，并用中文说明每个目录的用途。不要修改文件。

成功标志：

• Claude Code 能返回项目结构说明。
• 控制台调用日志能看到 /v1/messages 请求。
• 没有出现 401、404、模型不可用或协议不支持。

截图里只展示打码后的 token 示例。真实使用时，ANTHROPIC_AUTH_TOKEN 应填控制台创建的完整 sk-...，但不要写进公开文档或仓库。

确认只读任务成功后，再尝试小范围修改任务。

#可选：单次终端会话临时测试

如果你不想长期保存环境变量，可以只在当前终端会话里临时测试：

#macOS / Linux / WSL

ANTHROPIC_BASE_URL="https://www.wanmoapi.com" \
ANTHROPIC_AUTH_TOKEN="sk-..." \
claude

#Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://www.wanmoapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."
claude

临时变量只对当前窗口有效。关闭终端后会失效，适合首次排查，不适合长期使用。

#常见问题

#claude 命令找不到

关闭并重新打开终端，再执行 claude --version。Windows 用户要确认是在 PowerShell、CMD 还是 WSL 中安装的 Claude Code，不同环境的 PATH 不共享。

#CCSwitch 切换后还是走旧地址

检查：

• 是否关闭并重新打开终端。
• CCSwitch 面板里当前 provider 是否已经切到万模API。
• 本机是否还有旧的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 覆盖配置。
• Claude Code 是否运行在 WSL 内，而 CCSwitch 只配置了 Windows 原生环境。

#401 unauthorized

检查：

• ANTHROPIC_AUTH_TOKEN 是否是完整 sk-...。
• 是否同时设置了多个 Anthropic Key 变量，导致读取了旧 Key。
• 当前终端是否重新加载了环境变量。

#404 或协议错误

Claude Code 应走 Claude Messages。Base URL 填 https://www.wanmoapi.com，不要填 https://www.wanmoapi.com/v1/chat/completions。

如果日志里没有 /v1/messages，说明请求没有按 Claude Messages 协议进入万模API，优先检查 Base URL、CCSwitch provider 类型和旧环境变量。

#模型选择器没有显示万模API模型

先手动指定模型或换一个控制台确认可用的 Claude 协议模型。模型发现依赖客户端版本和网关 /v1/models 支持情况，不应作为唯一验证方式。

#Windows 原生还是 WSL

项目放在 Windows 文件系统时，用 PowerShell 原生 Claude Code 更简单；项目在 WSL 的 /home/... 下时，在 WSL 内安装并运行 Claude Code。

#Claude Code 能启动但任务中途失败

常见原因：

• 模型上下文不够。
• 工具调用不兼容。
• 客户端超时或网络中断。
• Claude Code 需要运行项目命令，但本机缺少 Node、Python、Go 等工具。

处理方式：

• 先降低任务范围，让 Claude Code 只读一个目录。
• 使用更稳定或更长上下文的 Claude 协议模型。
• 查看控制台调用日志里的原始错误。
• 按项目 README 安装依赖后再试。

#下一步

• 不确定协议：看协议选择指南。
• 本地工具缺失：看本地环境准备。
• 想统一管理多个编码 CLI：看CCSwitch 接入万模API。
• 请求失败：看常见问题排查。