Claude 模型 CLI 接入

Claude 系列模型适合长文本理解、代码分析、总结改写和复杂对话。AIRouter 通过 OpenAI 兼容接口提供 Claude 模型接入，实际可用模型 ID 以「模型广场」和 /v1/models 返回结果为准。

接入前准备

安装 Claude Code

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

如果提示 npm 不存在，请先安装 Node.js LTS 版本，再重新运行安装命令。

配置 Claude Code

打开 Claude Code 配置目录：

系统打开方式
Windows在 CMD 中运行 start "" "%USERPROFILE%\.claude"
macOS在终端中运行 open "$HOME/.claude"
Linux在终端中运行 mkdir -p "$HOME/.claude" && cd "$HOME/.claude"

Claude Code 配置目录

在目录中创建或编辑 settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://aigc.aochengcloud.com/claude",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存后关闭当前 Claude Code 进程，重新打开终端运行：

claude

Claude Code 运行示例

兼容地址说明

Claude Code 使用 Anthropic 原生协议，不是普通 OpenAI /v1 接口。若 https://aigc.aochengcloud.com/claude 不可用，请以平台公告或售后提供的 Claude Code 专用地址为准。

API 调用环境变量

如果你只是通过 curl 调用 OpenAI 兼容接口，可以使用下面的环境变量：

export AIROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export AIROUTER_BASE_URL="https://aigc.aochengcloud.com/v1"

先查询当前 API Key 可用的 Claude 模型：

curl -s "$AIROUTER_BASE_URL/models" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  | jq -r '.data[].id' \
  | grep -i 'claude'

如果本机没有 jq，可以直接查看完整响应：

curl "$AIROUTER_BASE_URL/models" \
  -H "Authorization: Bearer $AIROUTER_API_KEY"

注意

不要固定使用旧模型名，例如 claude-3-sonnet。模型名称、价格和权限可能会调整，请以实时查询结果为准。

基础调用

将 model 替换为你查到的 Claude 模型 ID：

curl "$AIROUTER_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍 Claude 适合处理什么任务。"
      }
    ]
  }'

系统提示词

Claude 对清晰的角色和输出格式要求响应较稳定。可以加入 system 消息约束回答风格：

curl "$AIROUTER_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "messages": [
      {
        "role": "system",
        "content": "你是一个严谨的技术文档助手。回答要简洁，使用中文。"
      },
      {
        "role": "user",
        "content": "说明 API Key、Base URL 和 model 三个配置项分别是什么。"
      }
    ]
  }'

流式输出

长回答建议使用流式输出，终端可以边生成边显示：

curl -N "$AIROUTER_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "请分步骤说明如何排查 API 调用返回 403。"
      }
    ]
  }'

长文本总结

可以把本地文本文件内容传给 Claude。下面示例会把 article.txt 的内容作为输入：

ARTICLE=$(cat article.txt)

jq -n --arg article "$ARTICLE" '{
  model: "claude-haiku-4-5-20251001",
  messages: [
    {
      role: "user",
      content: ("请用 5 条要点总结下面的内容：\n\n" + $article)
    }
  ]
}' | curl "$AIROUTER_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -d @-

如果终端不支持上面的拼接方式，可以先把文本粘贴到 content 字段中，确认调用链路跑通后再做脚本化封装。

代码分析

CODE=$(cat app.js)

jq -n --arg code "$CODE" '{
  model: "claude-haiku-4-5-20251001",
  messages: [
    {
      role: "user",
      content: ("请检查下面代码的潜在问题，并给出修改建议：\n\n" + $code)
    }
  ]
}' | curl "$AIROUTER_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -d @-

选择建议

场景建议
快速问答选择价格低、响应快的 Claude 模型
长文档总结选择上下文更长、稳定性更好的 Claude 模型
代码审查使用清晰的检查维度，例如安全、边界条件、可维护性
生产调用把模型 ID 做成配置项，避免模型调整时修改代码

常见问题

Q: 查不到 Claude 模型？

A: 先确认 API Key 是否有效、账号余额是否充足、API Key 是否设置了模型限制。如果 /v1/models 中没有 Claude 模型，请联系售后确认账号分组是否开放。

Q: 模型返回 403？

A: 通常是模型权限或 API Key 模型限制导致。请进入「API 密钥」页面检查 Model Limits，并在「模型广场」确认当前账号是否可用该模型。

Q: Claude 响应较慢怎么办？

A: 先换用更轻量的 Claude 模型测试；长文本任务建议开启流式输出；同时在「使用日志」中查看耗时和错误信息。

下一步

返回模型接入指南 →查询模型列表 →查看 API 调用 →
最后更新: