星狐API使用文档
    • 前言
    • 如何使用星狐云API？
    • OpenClaw配置API教程
    • HermesAgent配置星狐云 API 使用教程
    • Claude Code配置星狐云API教程【最新】
    • Vscode配置API使用教程
    • Codex配置星狐云API教程
    • CC Switch配置API教程
    • Obsidian 使用 Claudian教程
    • WorkBuddy配置API教程
    • 幻墨AI画图工具使用教程
    • 星狐Claw 一键部署 OpenClaw 使用教程
    • Chatbox使用教程
    • Cherry Studio使用教程
    • Gemini CLI API配置教程
    • Cursor配置API使用教程
    • Trae配置API教程
    • N8N 工作流配置中转API 教程
    • Dify配置API教程
    • 酒馆AI使用教程
    • Lovemo配置教程
    • 批量请求示例
    • 常见问题及解决办法
    • 售后支持
    • Python调用代码示例
      • Python 对话模型调用示例教程
      • Gemini 生图模型调用教程
      • GPTImage-2 中转 API 调用教程

    Vscode配置API使用教程

    星狐云中转API配置教程#

    本教程将指导你如何在 VSCode 中配置 Claude Code 和 Cline 插件使用星狐云中转API。

    目录#

    前置准备
    Claude Code 配置
    Cline 插件配置
    可用模型说明
    常见问题排查

    前置准备#

    1. 获取 API 密钥#

    1.
    访问星狐云官网：https://xinghuapi.com
    2.
    注册账号并登录
    3.
    进入控制台或个人中心
    4.
    找到令牌管理页面
    5.
    创建一个api令牌，设置名称，分组选择 Claude Code 专属分组或者其他Claude分组
    6.
    复制你的 API Key（格式为 sk-xxxxx）

    2. 安装必要工具#

    安装Node.js#

    Claude Code 依赖 Node.js 运行环境，请确保已安装 Node.js 18 及以上版本：
    1.
    访问 https://nodejs.org 下载 LTS 版本并安装
    2.
    安装完成后，在终端运行以下命令验证：
    能正常输出版本号即表示安装成功

    安装Git#

    Claude Code 需要 Git 来进行代码管理操作：
    1.
    访问 https://git-scm.com 下载并安装
    2.
    安装完成后，在终端运行以下命令验证：
    能正常输出版本号即表示安装成功
    提示：Windows 用户安装 Git 时，建议勾选 "Add Git to PATH" 选项，确保在任意终端可以使用 git 命令。

    VSCode 插件#

    Claude Code 插件：在 VSCode 扩展市场搜索 "claude" 并安装
    Cline 插件：在 VSCode 扩展市场搜索 "Cline" 并安装

    Claude Code 配置#

    方法一：通过配置文件#

    打开vscode的setting设置，在搜索框输入claude（必须安装好插件才行），然后点击下面显示出来的setting.json文件
    image.png
    在json文件下的claudecode环境变量里面，增加图中的实例代码，密钥改成自己创建的就行
    image.png
     {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://xinghuapi.com"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "星狐云令牌密钥"
    }
    3.
    保存文件并重启 Claude Code

    方法二：通过环境变量#

    在终端中设置环境变量：
    Windows (PowerShell):
    $env:ANTHROPIC_AUTH_TOKEN="sk-..."  # 替换为您的实际令牌
$env:ANTHROPIC_BASE_URL="https://xinghuapi.com"
    macOS/Linux (Bash/Zsh):

    Cline 插件配置#

    模型分组说明#

    星狐云为 Cline 插件提供了不同的模型分组，需要根据使用的模型选择对应的 API Key：
    分组名称可用模型API Key 获取位置
    Claude Code 专属分组Claude 系列模型星狐云令牌管理 - Claude Code 专属分组
    Codex 分组GPT 系列模型星狐云令牌管理 - Codex 分组
    重要：使用 Claude 模型时，必须使用 Claude Code 专属分组的 API Key；使用 GPT 模型时，必须使用 Codex 分组的 API Key。

    配置步骤#

    1.
    打开cline插件设置按钮找到以下配置项并填写：
    image.png
    API Provider: 选择 OpenAI Compatible
    Base URL: 填入 https://xinghuapi.com/v1
    OpenAI Compatible API Key: 填入你的星狐云 API 令牌密钥
    Model ID: 填入你想用的模型ID（见下方模型说明）

    验证配置#

    1.
    在 VSCode 中打开 Cline 面板
    2.
    发送一条测试消息，如 "你好"
    3.
    如果收到正常回复，说明配置成功

    可用模型说明#

    Claude 模型列表#

    星狐云 Claude Code 专属分组支持以下 Claude 模型：

    推荐模型#

    模型名称模型ID特点适用场景
    Claude Sonnet 4.6claude-sonnet-4-6平衡性能与成本日常开发、代码生成
    Claude Opus 4.6claude-opus-4-6最强性能复杂任务、架构设计
    Claude Haiku 4.5claude-haiku-4-5-20251001快速响应简单查询、快速迭代

    模型选择建议#

    新手用户：推荐使用 claude-sonnet-4-6，性价比最高
    专业开发：推荐使用 claude-opus-4-6，能力最强
    快速测试：推荐使用 claude-haiku-4-5-20251001，响应最快

    常见问题排查#

    1. 连接失败 / 超时#

    问题表现：
    提示 "Connection timeout"
    提示 "Failed to connect to API"
    解决方案：
    检查网络连接是否正常
    确认 API Base URL 是否正确：https://xinghuapi.com/v1
    检查防火墙或代理设置
    尝试在浏览器访问 https://xinghuapi.com 确认服务可用

    2. 认证失败#

    问题表现：
    提示 "Invalid API key"
    提示 "Authentication failed"
    HTTP 401 错误
    解决方案：
    确认 API Key 是否正确复制（注意前后空格）
    检查 API Key 是否已过期
    登录星狐云控制台确认 API Key 状态
    尝试重新生成 API Key

    3. 模型不可用#

    问题表现：
    提示 "Model not found"
    提示 "Invalid model"
    解决方案：
    检查模型名称是否正确（区分大小写）
    Cline 插件用户：确认使用的是正确分组的 API Key（Claude 模型需要 Claude Code 专属分组，GPT 模型需要 Codex 分组）
    确认你的账户是否有权限使用该模型
    尝试使用推荐的模型 ID：claude-sonnet-4-6
    联系星狐云客服确认可用模型列表

    4. 配额不足#

    问题表现：
    提示 "Rate limit exceeded"
    提示 "Quota exceeded"
    HTTP 429 错误
    解决方案：
    登录星狐云控制台查看剩余额度
    充值或升级套餐
    等待配额重置（如有时间限制）
    减少请求频率

    5. Claude Code 无法启动#

    问题表现：
    命令行提示找不到命令
    启动后立即退出
    解决方案：
    确认 Claude Code 已正确安装
    检查环境变量 PATH 是否包含 Claude Code 路径
    尝试重新安装 Claude Code
    Windows 用户：以管理员身份运行

    6. Cline 插件无响应#

    问题表现：
    发送消息后无反应
    插件面板显示错误
    解决方案：
    重启 VSCode
    检查 Cline 插件是否已启用
    查看 VSCode 输出面板（Output）中的 Cline 日志
    尝试重新安装 Cline 插件
    确认 settings.json 配置格式正确

    7. 响应速度慢#

    问题表现：
    等待时间过长
    经常超时
    解决方案：
    切换到更快的模型（如 Haiku）
    检查网络延迟
    减少单次请求的上下文长度
    避免高峰时段使用

    技术支持#

    如遇到其他问题，可通过以下方式获取帮助：
    星狐云官网：https://xinghuapi.com
    在线客服：访问官网联系客服
    文档中心：查看星狐云官方文档
    最后更新时间：2026-04-02
    文档版本：v1.0
    修改于 2026-04-15 06:05:51
    上一页
    Claude Code配置星狐云API教程【最新】
    下一页
    Codex配置星狐云API教程
    Built with