在Claude Code中接入OspreyAI模型

本文档介绍如何通过 Anthropic API 兼容接口，在 Claude Code 中调用ospreyai平台提供的 LLM模型（如 glm-4.6、deepseek-R1 等）。

前提条件

• 已开通ospreyai服务

  • 首次使用请登录 ospreyai 。

  • 获取 API Key 。

安装 Claude Code

在终端中执行以下命令安装：npm install -g @anthropic-ai/claude-code

Windows 用户注意：需先安装 WSL 或 Git for Windows，并在 WSL 或 Git Bash 中执行安装命令。详情参考 Claude Code 官方 Windows 安装指南 。

配置环境变量

为使 Claude Code 调用阿里云百炼模型，需设置以下环境变量：

ANTHROPIC_BASE_URL	open.ospreyai.cn
ANTHROPIC_API_KEY或`ANTHROPIC_AUTH_TOKEN	ospreyai平台的api

Linux / macOS（Bash 或 Zsh）

判断 Shell 类型：echo $SHELL

• Zsh（通常为 macOS 默认）：

echo 'export ANTHROPIC_BASE_URL="https://open.ospreyai.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

• Bash：

echo 'export ANTHROPIC_BASE_URL="https://open.ospreyai.cn"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bash_profile
source ~/.bash_profile

验证设置：

echo $ANTHROPIC_BASE_URL 
echo $ANTHROPIC_AUTH_TOKEN

Windows

CMD

setx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_BASE_URL "https://open.ospreyai.cn"

重启 CMD 窗口后生效。

验证：

echo %ANTHROPIC_AUTH_TOKEN% 
echo %ANTHROPIC_BASE_URL%

PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://open.ospreyai.cn, [EnvironmentVariableTarget]::User)

重启 PowerShell 窗口后生效。

验证：

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

在 Claude Code 中使用LLM模型

支持的模型列表

模型类别	可用模型名称
glm	glm-4.6-fp8
deepseek	deepseek-r1-0528

指定模型的方式

1. 启动时指定

claude --model glm-4.6-fp8

1. 对话中切换

在 Claude Code 会话中输入：

/model glm-4.6-fp8

1. 通过环境变量设置（推荐）

bash

export ANTHROPIC_MODEL="glm-4.6-fp8"
export ANTHROPIC_SMALL_FAST_MODEL="glm-4.6-fp8"

1. 项目级配置文件（永久生效）

在项目根目录创建 .claude/settings.json：

{
  "env": {
    "ANTHROPIC_MODEL": "glm-4.6-fp8",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-4.6-fp8"
  }
}

运行 Claude Code

进入你的项目目录并启动：

cd my-project
claude

如何节省 Token？

• 减少无关文件：仅在必要项目目录中运行，避免扫描无关文件。

• 手动压缩上下文：使用 /compact 命令总结对话历史。

• 重置上下文：新任务前执行 /clear。

• 明确指令：避免模糊请求，减少不必要的文件扫描。

• 分解复杂任务：拆分为多个小任务处理。

更多技巧参考 Claude Code 官方文档 。

Code-Switch 中文使用说明

统一管理 Claude Code / Codex API 的多供应商代理工具 支持自动切换、自动降级、高可用路由、请求用量统计 基于 Wails 3 + Vue 3

---

项目简介

code-switch 是一个提供“多供应商 AI API 自动切换”的本地代理工具。 它能够将 cc / codex 等命令行工具的请求统一接入本地代理，从而实现：

• 多供应商集中管理

• 自动降级与故障切换 (Failover)

• 统一 API Endpoint

• 平滑切换供应商，无需重启 cc / codex

• 每次请求的用量统计（Token / 单价）

• 支持 MCP server、技能 Skill 自动安装

使用 code-switch 后，你只需要把 cc / codex 的 API 地址指向：http://127.0.0.1:18100剩下的自动路由、优先级切换、降级处理都由 code-switch 完成。

---

核心功能

1. 多供应商动态切换

你可以配置多个 Claude / Codex 供应商（官方、镜像、第三方），code-switch 会：

• 优先用你设定的主供应商

• 如果超时/失败 → 自动回退到其他供应商（降级机制）

• 失败后自动恢复主供应商（健康检查）

---

2. 平滑切换，无需重启 cc/codex

改变配置后不需要重启 cc / codex 工具，所有变更即时生效。

---

3. 用量 / Token 统计

每次请求都会记录：

• 供应商名称

• 请求类型

• 输入 token / 输出 token

• 总 token

• 费用估算

方便你管理多个 key。

---

4. MCP Server 支持

支持：

• Claude Code MCP

• Codex MCP

并允许你添加自定义 MCP server。

---

5. Skill 自动下载 & 管理

内置两个 Skill 仓库，可自动下载、管理、启用/禁用技能，也支持添加自定义仓库。

---

技术架构概览

cc / codex CLI
        ↓http://127.0.0.1:18100
        ↓
──────────────code-switch proxy
──────────────
    ↓      ↓      ↓provider A  provider B  provider C
 (主)        (备)        (备)

代理服务器只处理关键兼容端点：

• /v1/messages → Claude API

• /responses → Codex API

自动根据 “启用状态 + 优先级 + 健康情况” 做路由。

---

安装与构建

环境要求

组件	最低版本
Go	1.24+
Node.js	18+
Wails	v3

安装 Wails CLI：go install github.com/wailsapp/wails/v3/cmd/wails3@latest

---

开发模式运行

git clone https://github.com/daodao97/code-switch.git cd code-switch wails3 task dev将启动本地调试界面，并在后台运行代理服务。

---

构建发行版本

1. 同步 build 资源

wails3 task common:update:build-assets

1. 构建 macOS

wails3 task package

1. 构建 Windows (在 macOS 下需要 mingw-w64)

brew install mingw-w64 env ARCH=amd64 wails3 task windows:build env ARCH=amd64 wails3 task windows:package

1. 自动发布脚本

scripts/publish_release.sh v0.1.0

---

使用方法

① 启动 code-switch

打开应用（开发版或打包版均可）它会自动监听：127.0.0.1:18100

② 配置 cc / codex 使用该代理

在你的 cc 或 codex 配置文件，把 API endpoint 改为：{ "apiUrl": "http://127.0.0.1:18100" }或命令行：export CC_API_BASE=http://127.0.0.1:18100 export CODEX_API_BASE=http://127.0.0.1:18100

③ 添加供应商（Provider）

在 UI 中配置：

• Base URL

• API Key

• 优先级

• 超时策略

• 启用/禁用

---

使用示例

使用 cc 调用 Claude：cc chat -m claude-3.5 “帮我写一个 Python 快速排序”你会看到：

• 供应商自动选择

• token 用量统计

• 如果主供应商挂了，自动切到备用供应商

---

常见问题 (FAQ)

Q1：cc / codex 请求失败怎么办？

检查：

• 是否监听 18100 端口

• 是否正确配置 apiUrl

• 供应商是否启用

• key 是否有效

• 是否开启代理模式

Q2：Skill 安装失败？

可能是仓库地址不稳定，可添加自定义 skill 仓库。

Q3：macOS 无法打开 .app？

需执行：wails3 task common:update:build-assets然后重新构建。

---