汇飞智能

Claude Code 接入 汇飞智能 教程

Claude Code 是 Anthropic 官方出品的终端智能编码工具，可以通过自然语言命令直接在命令行中帮你完成代码生成、读取本地文件、调试和重构等任务。

通过接入 汇飞智能 ，修改环境变量，您可以将 Claude Code 的默认官方接口替换为 汇飞智能，从而享受更稳定、高性价比的 API 服务。

一、接入前准备

开始前，请先准备好以下核心配置信息。请登录 汇飞智能 控制台获取你的专属密钥：

配置项推荐填写内容注意事项
API Keysk-xxxxxxxxxxxxxxxx填写控制台 Key
Base URLhttps://api.sapis.cn不要 /v1 后缀
模型名如 deepseek-v4.1-flash汇飞智能不提供 Claude 模型，必须指定一个汇飞支持的模型（需支持工具调用）

二、安装 Claude Code

请确保你的电脑已安装 Node.js 18 或更高版本。打开终端（Windows 推荐使用 Git Bash 或 WSL，本文同时给出 PowerShell 方案），先运行 node --version 检查当前环境。

node --version

然后依次运行以下命令：

1. 基础安装

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

2.（可选）升级为原生安装

如需使用原生安装模式，可在基础安装完成后运行：

claude install
  • 提示：可用 claude --version 输出正常版本号来确认安装成功。

三、Windows 用户专属避坑指南

如果你使用 Git Bash 或 WSL，可直接跳过本节。使用 PowerShell 的 Windows 用户，系统较严格的安全策略通常会拦截 Claude Code 的运行，请务必在配置前执行以下操作（Mac/Linux 用户可直接跳过）：

1. 解除脚本运行限制

在 PowerShell 中运行以下命令。如果系统提示是否更改执行策略，请输入 Y 并回车确认：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 防坑说明：如果不执行此步，运行 claude 时会报红字错误，在此系统上禁止运行脚本。

2. 解决“无法识别 claude”报错

如果你输入claude提示找不到命令，说明安装路径没有自动加入环境变量。

  • 按 Win 键搜索“环境变量”，将 C:\Users\你的用户名\.local\bin 路径添加到当前用户的 Path 变量中，然后重启 PowerShell。

四、配置 汇飞智能 并启动

重要：Claude Code 默认会请求 Anthropic 官方 Claude 模型，而 汇飞智能不提供 Claude 模型。你必须通过环境变量把模型改成汇飞支持的模型，否则启动时会因「模型不存在」或 credit balance is too low 而失败。若你之前登录或配置过 Anthropic 官方账号，建议先清除 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 等旧值，避免冲突。

Claude Code 严格依赖环境变量来识别自定义代理。请务必确保设置变量和运行命令在同一个终端窗口中进行。

方式一：临时配置（推荐首次测试使用）

打开终端（Windows 可打开 PowerShell 或 Git Bash），按顺序逐行粘贴以下代码并回车：

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL="https://api.sapis.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的汇飞智能密钥"
$env:ANTHROPIC_MODEL="deepseek-v4.1-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4.1-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4.1-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
claude

macOS / Linux:

export ANTHROPIC_BASE_URL="https://api.sapis.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的汇飞智能密钥"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"
claude

将上面的 deepseek-v4.1-flash 换成控制台里支持 Claude Code 的模型（需支持工具调用）；四个模型变量可填同一个模型。

方式二：长期配置（永久生效，推荐）

如果你希望以后每次打开终端直接输入 claude 就能用，无需每次敲代码设置变量，请配置系统的全局环境变量：

  • Windows: 在系统“环境变量” -> “用户变量”中，新建以下变量：ANTHROPIC_AUTH_TOKEN（你的 Key）、ANTHROPIC_BASE_URL（https://api.sapis.cn），以及 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL（后四个填同一个汇飞模型名，如 deepseek-v4.1-flash），配置后重启终端。

  • Mac/Linux: 将方式一中的 export 语句写入你的 ~/.zshrc 或 ~/.bashrc 文件中，并执行 source ~/.zshrc。

五、如何测试是否成功？

当你在设置了环境变量的终端中输入 claude 并回车后：

  1. 系统不会再提示红色的 Not logged in · Please run /login。

  2. 你将直接进入带有 > 提示符的交互界面。

  3. 输入一个简单的测试问题，例如：请帮我用 Python 写一个 Hello World。

  4. 如果 Claude 能够正常输出代码，说明接入成功。

如果启动时报「模型不存在」或 credit balance 相关错误，多半是模型变量没设置或模型名写错，请检查 ANTHROPIC_MODEL 等四个模型变量是否已设为汇飞支持的模型。

六、常见问题 (FAQ)

Q1：报错信息：Your credit balance is too low to access the Anthropic API.

  1. 可能 汇飞智能 账号没有余额了：你填入的这个 sk-... 的 Key，里面对应的 Token 额度可能已经耗尽了，充值即可。

  2. 如果 汇飞智能 账号有余额，通常是模型变量没配置好（见第四章），请确认 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 已设为汇飞支持的模型。也可以在 Claude Code 界面内临时切换：

/model deepseek-v4.1-flash
  • （可以把 deepseek-v4.1-flash 换成控制台里面支持的海量模型）
  1. 若模型与分组不匹配，还可以换分组：在控制台 API 密钥页面点击编辑，切换分组，然后提交即可。

Q2：为什么还是提示 Not logged in / Please run /login？

  • 检查变量名是否是 ANTHROPIC_AUTH_TOKEN。

  • 最常见原因：环境变量是单窗口生效的。你可能在窗口 A 设置了变量，却在新开的窗口 B 运行了 Claude。请务必在同一个窗口内操作。

Q3：Base URL 加不加 /v1？

  • 不加/v1，在目前 汇飞智能 的接口规范和 Claude Code 的新版逻辑下，请严格填写 https://api.sapis.cn

Q4：不小心输入了 /login 怎么办？

  • /login 是用来登录 Anthropic 官方账号的。如果你接入的是 汇飞智能，请不要使用此命令。如果不小心进入了登录界面，一直按 Esc 键退出即可，系统会自动退回并读取你的环境变量。
不会配置？联系我们首次免费远程协助配置