Claude Code 接入 Opus 5.5 保姆级教程

Claude Code 接入 Claude Opus 5.5 实战指南

环境说明：macOS + Claude Code 2.1.286，中转站 https://momoai.asia，模型 ID claude-opus-5-5。文中截图 Key 已脱敏，示例统一使用占位符 sk-xxxx。

核心目标

• 切换接口：将 Claude Code（Anthropic 官方终端 AI 编程工具）的请求从官方 API 转向 momoai.asia 中转服务；
• 固定模型：默认锁定为 Claude Opus 5.5（claude-opus-5-5），免去每次手动切换的繁琐；
• 快速排查：通过 curl 命令优先验证 Key 和模型可用性，再启动 claude，精准定位网络、Key 或配置问题。

操作逻辑简化为三步：获取 Key → 配置 ~/.claude/settings.json → curl 验证后启动。

一、安装与升级 Claude Code

根据官方文档推荐，可选择以下任意一种方式安装（macOS / Linux / WSL），切勿混用以免版本冲突。

1. 原生安装脚本（推荐）

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

2. npm 全局安装

需 Node.js 22+ 环境。

# 首次安装
npm install -g @anthropic-ai/claude-code

# 升级请使用 @latest，避免使用 npm update -g
npm install -g @anthropic-ai/claude-code@latest

3. Homebrew 安装

brew install --cask claude-code

注意：本文实测采用 npm 方式（nvm 管理 Node 22）。安装完成后，请新开终端窗口执行 claude --version 确认版本号，或运行 claude doctor 进行诊断。

二、获取 momoai API Key

1. 访问 https://momoai.asia 注册并登录控制台；
2. 创建新的 API Key（令牌）；
3. 关键步骤：创建时确认所选分组包含 claude-opus-5-5 模型，不同分组计费倍率与可用模型各异；
4. 复制 Key 并妥善保存于本机，严禁分享至群组、Git 仓库或公开截图。

三、配置 ~/.claude/settings.json

1. 备份配置文件

修改前务必备份，以防配置错误导致服务不可用。

cp ~/.claude/settings.json ~/.claude/settings.json.bak

2. 编辑配置内容

打开 ~/.claude/settings.json，填入以下结构（替换为你的实际 Key）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://momoai.asia",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx" 
  },
  "model": "claude-opus-5-5"
}

配置要点：

• ANTHROPIC_BASE_URL：填写根域名，不要带 /v1，Claude Code 会自动拼接路径；
• ANTHROPIC_AUTH_TOKEN：填入获取的 API Key；
• model：指定默认模型 ID。

四、前置验证：使用 curl 测试

在正式启动 Claude Code 前，建议通过终端命令验证 Key 有效性及模型权限。

1. 检查可用模型列表

export MOMO_KEY="sk-xxxx" # 替换为真实 Key
curl -s https://momoai.asia/v1/models \
  -H "x-api-key: $MOMO_KEY" \
  | grep -o '"id":"claude-opus-5-5"'

若输出包含 "id":"claude-opus-5-5"，说明 Key 有效且该分组支持该模型。若无输出，可去掉 grep 查看完整返回，或使用 jq -r '.data[].id' 列出所有可用模型。

2. 发送测试消息

curl -s https://momoai.asia/v1/messages \
  -H "x-api-key: $MOMO_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-opus-5-5","max_tokens":32,
       "messages":[{"role":"user","content":"只回复 OK"}]}' \
  | grep -oE '"model":"[^"]+"|"text":"[^"]*"'

正常返回应包含 "model":"claude-opus-5-5" 和 "text":"OK"。此处设置较小的 max_tokens 以节省测试额度。momoai 兼容 Authorization: Bearer 和 x-api-key 两种认证头。

五、启动与确认

进入项目目录并启动：

cd your-project
claude

进入会话后执行以下检查：

• 输入 /model：确认当前模型为 claude-opus-5-5；
• 输入 /status：查看会话配置详情；
• 提问验证：询问“当前使用模型”，但请以 /model 指令及中转站后台日志为准，模型自述可能存在偏差。

若模型未切换成功，检查 Shell 环境变量中是否残留旧的 ANTHROPIC_MODEL，可通过 env | grep ANTHROPIC 排查。

六、常见问题排查

1. Python SSL 证书错误

macOS 使用 python.org 安装包时常见 SSL: CERTIFICATE_VERIFY_FAILED。此为本地 Python 证书库问题，不影响 curl 测试。修复方法：运行 Python 安装目录下的 Install Certificates.command 或在代码中引入 certifi。

2. 模型 ID 格式错误

必须严格使用 claude-opus-5-5，而非 claude-opus-5.5 或 Claude Opus 5.5。请以 /v1/models 接口返回的 ID 为准。

3. Base URL 重复拼接

ANTHROPIC_BASE_URL 仅需填写 https://momoai.asia。若添加 /v1，会导致请求路径变为 /v1/v1/messages 从而引发 404 错误。

4. 401/403 鉴权失败

按以下顺序排查：

• Key 是否复制完整（注意首尾空格或换行）；
• settings.json 字段名是否正确；
• Shell 环境中是否存在旧的 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 覆盖配置；
• Key 所在分组是否包含目标模型，以及账户余额是否充足。

5. 命令未找到或二进制丢失

若出现 claude: command not found，通常因升级中断、Node 版本切换或全局目录清理导致。重新执行安装命令即可，重装不会覆盖 ~/.claude/settings.json。

6. 配置修改不生效

settings.json 仅在启动时读取。修改配置后，必须退出并重新启动 claude 会话。

七、成本分析与优化

中转站计费基于分组倍率，具体价格请以 momoai 后台账单为准。理解 Token 构成有助于优化成本：

类型	Tokens	说明
输入 (input)	75,116	未命中缓存的原始输入
输出 (output)	302	模型生成的回复内容
缓存读 (cache read)	98,256	命中提示缓存部分，单价通常最低
缓存写 (cache write)	36,846	首次写入缓存，单价略高于普通输入

优化建议：

• Claude Code 的主要消耗在于输入和缓存（系统提示词、文件上下文），而非输出；
• 在同一会话中连续工作可提高缓存命中率，比频繁开启新会话更经济；
• 精简无关大文件，适时使用 /compact 或开启新会话清理上下文，简单任务可切换至低价模型。

八、进阶应用

配置完成后，可利用 Claude Code + Opus 5.5 的强大能力生成 Remotion React 代码，并通过 npx remotion render 渲染 MP4 视频，实现自动化短视频制作。

速查清单

安装命令   : curl -fsSL https://claude.ai/install.sh | bash 
           : 或 npm i -g @anthropic-ai/claude-code
配置文件   : ~/.claude/settings.json (修改前务必备份)
Base URL   : https://momoai.asia (严禁携带 /v1)
Token 变量 : env.ANTHROPIC_AUTH_TOKEN
模型 ID    : claude-opus-5-5
验证流程   : curl /v1/models → curl /v1/messages → 启动 claude → 检查 /model