已有账号？直接查看 快速开始 配置工具。 想了解平台全貌？请查看 平台导航。

一、获取 API Key ​

1. 注册账号 ​

访问 fishxcode.com，点击注册：

选择注册方式（GitHub、LinuxDO 或用户名注册）：

填写用户名、密码和确认密码完成注册：

2. 登录 ​

注册完成后使用用户名和密码登录：

登录后进入控制台：

3. 创建令牌 ​

进入控制台 → 令牌管理 → 添加令牌，填写表单：

• 令牌分组建议选择 官渠，该分组包���全系列 Claude 模型，会根据任务复杂度自动选择，无需手动切换。具体渠道和模型以官网实际为准，请前往 定价页 查看最新信息。

创建完成后在令牌列表点击复制按钮获取 API Key（格式为 sk-xxx）：

4. 充值 ​

进入控制台 → 钱包管理，支持支付宝、微信或兑换码：

| 方式 | 操作路径 | |

这页解释 FishXCode 的计费口径、令牌分组和套餐页面之间的关系。你可以把它当成购买和创建 Key 前的检查清单：先看定价页确认模型和套餐，再看分组决定 Key 能调用什么，最后用使用日志和分组健康状态核对实际消耗。

截图对应模块 ​

| 截图 | 对应问题 | |

适用范围 ​

本文适用于 Claude Desktop 新版的 Cowork / Code 第三方推理接入 模式，也就是 Anthropic 官方文档中的 third-party inference。

如果你想要的是：

• 在桌面端使用 Claude 的 Cowork
• 在桌面端使用 Claude 的 Code
• 通过自定义 API / 网关把请求转到 FishXCode

那么走的就是这套配置方式。

前置准备 ​

开始前请先准备：

1. 安装最新版 Claude Desktop
2. 准备一个 FishXCode Token
3. 确认你的 Token 可访问 Claude 模型

Token 获取地址：

• https://fishxcode.com/console/token

建议优先准备这些模型作为候选：

• claude-sonnet-4-5-20250929
• claude-opus-4-5-20251101
• claude-haiku-4-5-20251001

方式一：在 Claude Desktop 里直接配置（推荐） ​

Anthropic 官方推荐优先通过桌面端内置的第三方推理配置界面完成设置。

1. 启用 Developer mode ​

在 Claude Desktop 顶部菜单中依次进入：

Help → Troubleshooting → Enable Developer mode

启用后，应用菜单里会出现 Developer 相关入口。

2. 打开第三方推理配置 ​

继续进入：

Developer → Configure third-party inference

这里会打开一套 Anthropic 官方提供的第三方推理配置流程。

3. 选择 Gateway 模式 ​

在提供商类型里，选择：

Gateway

FishXCode 这类自定义 API / 中转服务，对应的就是 gateway 模式。

4. 填写 FishXCode 配置 ​

核心信息按下面填写：

• Gateway URL：https://api.fishxcode.com
• Authentication：x-api-key
• API Key：你的 FishXCode Token

如果界面要求填写模型列表，建议先填：

claude-sonnet-4-5-20250929
claude-opus-4-5-20251101
claude-haiku-4-5-20251001

如果界面支持启用 Code，保持开启即可。

5. 应用到本地 ​

完成配置后，优先选择：

Apply locally

这会把第三方推理配置写入当前用户的本地 Claude Desktop 配置中。

配置成功后，重新打开 Claude Desktop，通常就能看到可用的 Cowork / Code 工作界面。

方式二：通过本地配置文件管理（进阶） ​

如果你想备份、迁移或排查配置，可以查看 Claude Desktop 本地写入的位置。

常见路径如下：

macOS ​

~/Library/Application Support/Claude-3p/claude_desktop_config.json

Windows ​

%APPDATA%\Claude-3p\claude_desktop_config.json

Linux ​

~/.config/Claude-3p/claude_desktop_config.json

FishXCode 推荐配置 ​

如果你要手动核对字段，重点关注下面几项：

| 字段 | 建议值 | |

首次使用？请先完成 账户注册与充值，并在 FishXCode 控制台 创建可用 Token。

适用范围 ​

本文适用于 OpenAI Codex 桌面端接入 FishXCode。命令行版 Codex 的安装和配置可直接参考 在 Codex 中使用 FishXCode，桌面端也建议复用同一套 ~/.codex 配置，减少重复维护。

一、安装 Codex Desktop ​

Windows 用户可在 Microsoft Store 搜索 Codex，找到官方应用后安装：

安装完成后，先不要急着登录，建议先完成下一步本地配置。若无法访问 Microsoft Store，请优先使用 OpenAI 官方发布渠道或可信的软件分发渠道下载安装包。

二、复用 Codex 配置接入 FishXCode ​

Codex Desktop 与 Codex CLI 建议使用同一套用户配置。配置内容与 Codex 命令行教程 保持一致。

1. 创建配置目录 ​

mkdir -p ~/.codex

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"

2. 写入 config.toml ​

在 ~/.codex/config.toml 中写入：

model_provider = "fishxcode"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "medium"
model_reasoning_summary = "detailed"
disable_response_storage = true
preferred_auth_method = "apikey"
model_verbosity = "high"

[model_providers.fishxcode]
name = "OpenAI using Chat Completions"
base_url = "https://api.fishxcode.com/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
skills = true
image_generation = false

3. 写入 auth.json ​

在 ~/.codex/auth.json 中写入 FishXCode Token：

{
  "OPENAI_API_KEY": "your_api_key_here"
}

三、登录 Codex Desktop ​

打开 Codex Desktop 后，如果出现登录页，选择 使用其他方式登录：

然后粘贴 FishXCode 控制台中复制的 Token。若你已经写入 ~/.codex/auth.json，仍然遇到登录提示，也可以在这里再次粘贴同一个 Token。

如果需要复制 Token，可在 FishXCode 控制台令牌页找到对应 Token，点击密钥旁的复制按钮。截图中不展示复制菜单，避免教程图片暴露不必要的密钥信息。

登录后进入项目目录，选择要让 Codex 操作的文件夹，即可开始使用。

四、可选：用 CC Switch 管理多渠道 ​

如果你同时维护多个 Codex 渠道，可以使用 CC Switch 做快速切换；如果只使用 FishXCode，一个 ~/.codex/config.toml 通常已经足够。

在 FishXCode 控制台令牌页找到目标令牌后，点击 codex_sub_june 分组对应行的 导入：

CC Switch 导入弹窗中选择 Codex 应用后，核心字段建议保持：

| 字段 | FishXCode 推荐值 | |

选择适合你的 AI 编程工具。以下是 FishXCode 平台支持的各工具全面对比。

基本信息 ​

| 工具 | 开发者 | 类型 | |

错误日志用于定位单次请求失败的具体原因。排查时建议先查看 分组健康状态 判断影响范围，再用错误日志里的 request_id 定位单条请求。

入口：控制台 → 使用日志。将日志类型切换为 错误日志 后，可按时间、模型、Token、分组、请求 ID、错误消息和状态码筛选。

字段说明 ​

| 字段 | 含义 | 排查价值 | |

通用 ​

FishXCode 是什么？ ​

FishXCode 是一个 AI Coding 中转站，支持 Claude、Codex 模型在多种平台使用。

支持哪些工具？ ​

目前支持以下工具：

• Claude Code — Anthropic 官方 CLI
• OpenAI Codex — OpenAI 官方编程助手
• RooCode — VS Code AI 编程插件
• Qwen Code — 阿里通义千问编程工具
• Droid CLI — 轻量级 AI 编程 CLI
• OpenCode — 开源 AI 编程终端工具

数据隐私如何保障？ ​

FishXCode 仅作为 API 中转服务，不存储你的代码和对话内容。所有请求直接转发至对应的模型提供商。

账户与 Token ​

如何注册？ ​

访问 fishxcode.com/register，按提示完成注册即可。

如何获取 API Token？ ​

注册后登录控制台，前往 Token 管理页 创建新的 Token。

Token 有效期多长？ ​

Token 在手动删除或重新生成前持续有效。建议定期轮换以确保安全。

用量额度是多少？ ​

FishXCode 为每个用户提供用量额度，具体数量根据平台资源动态调整。请关注控制台中的用量信息。

工具配置 ​

环境变量设置后不生效怎么办？ ​

检查以下常见原因：

1. 未重启终端 — 修改 .bashrc / .zshrc 后需要执行 source ~/.bashrc 或新开终端
2. 变量名拼写错误 — 注意区分大小写，如 ANTHROPIC_BASE_URL 不能写成 Anthropic_Base_Url
3. 多余的引号或空格 — export KEY="value" 中 value 前后不要有多余空格

# 检查变量是否已设置
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# 如果为空，说明变量未生效

配置文件路径在哪里？ ​

| 工具 | 配置文件路径 | |

前置准备 ​

在开始前，你需要先准备好：

1. 一个 FishXCode 账号
2. 一个可用的 API Token
3. 确认当前 Token 可以访问 gpt-image-2

获取 Token：

• 控制台地址：https://fishxcode.com/console/token

开源可视化工具 ​

如果你不想先写代码，可以直接使用 FishXCode 提供的开源 GPT-Image-2 工具进行测试和出图：

• 在线体验：https://fishxcode-gpt-image-2.lovable.app/
• 开源仓库：https://github.com/fishxcode/gpt-image-2

方式一：使用 Images API 生成图片 ​

这是最直接的方式，对应 OpenAI 兼容的图片生成接口。

• 请求地址：https://api.fishxcode.com/v1/images/generations
• 模型名称：gpt-image-2

Python 示例 ​

import base64
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的FishXCode-Token",
    base_url="https://api.fishxcode.com/v1"
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="一只戴着宇航员头盔的橘猫，坐在月球表面，电影级光影，超清细节",
    size="1024x1024"
)

image_base64 = result.data[0].b64_json

with open("gpt-image-2-output.png", "wb") as f:
    f.write(base64.b64decode(image_base64))

Node.js 示例 ​

import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的FishXCode-Token",
  baseURL: "https://api.fishxcode.com/v1",
});

const result = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一座漂浮在云海上的未来城市，赛博朋克霓虹风格，超高细节",
  size: "1024x1024",
});

const imageBase64 = result.data[0].b64_json;
fs.writeFileSync("gpt-image-2-output.png", Buffer.from(imageBase64, "base64"));

curl 示例 ​

curl --request POST \
  --url https://api.fishxcode.com/v1/images/generations \
  --header "Authorization: Bearer sk-你的FishXCode-Token" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一张极简产品海报，白色背景，中央是一枚悬浮的透明玻璃键盘，商业摄影风格",
    "size": "1024x1024"
  }'

方式二：通过 Chat Completions 调用图片生成 ​

如果你的工作流已经基于 /v1/chat/completions，也可以直接在对话接口里调用 gpt-image-2。

• 请求地址：https://api.fishxcode.com/v1/chat/completions
• 模型名称：gpt-image-2

Python 示例 ​

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的FishXCode-Token",
    base_url="https://api.fishxcode.com/v1"
)

response = client.chat.completions.create(
    model="gpt-image-2",
    messages=[
        {
            "role": "user",
            "content": "画一只戴墨镜的柴犬，坐在复古红色敞篷车里，公路旅行风格"
        }
    ]
)

print(response)

curl 示例 ​

curl --request POST \
  --url https://api.fishxcode.com/v1/chat/completions \
  --header "Authorization: Bearer sk-你的FishXCode-Token" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-image-2",
    "messages": [
      {
        "role": "user",
        "content": "画一间日落时分的日式咖啡馆，暖色电影感构图"
      }
    ]
  }'

常用参数说明 ​

gpt-image-2 常见可用参数如下：

| 参数 | 含义 | 示例 | |

分组健康状态用于判断调用异常是单个请求问题，还是某个套餐、模型、上游分组或团队成员的集中问题。企业和团队管理员可以用它快速回答三个问题：

• 哪个分组在指定时间范围内成功率下降
• 哪个用户或令牌贡献了主要请求量、消耗或错误
• 错误是集中在单个 Token，还是已经影响整个分组

排查接口异常时，先看分组健康状态，再进入单条使用日志定位具体 request_id。

如果上方状态页未正常加载，可直接打开 FishXCode 分组健康状态。

控制台入口：控制台 → 使用日志。在错误日志或统计视图中，按时间范围、模型、Token、分组、错误消息和状态码筛选。

控制台示例 ​

下面是控制台 使用日志 → 分组健康状态 的示例截图，展示分组的成功率、请求数、消耗、缓存命中、平均耗时、最近请求时间和失败原因。

需要解释单条错误消息时，请查看 错误日志说明。

列表展示字段 ​

控制台列表和 CSV 导出的展示列保持一致。列表同时展示两类行：

• 分组行：汇总一个分组在当前时间范围内的整体健康状态。
• 令牌行：展示某个分组下的用户和令牌明细，便于企业、团队管理员定位成员、项目或服务。

| 展示字段 | 适用行 | 字段说明 | 使用建议 | |

前提条件 ​

• 已安装 OpenClaw（参考下方安装章节）
• 已获取 FishXCode API Key（控制台获取）

核心特性 ​

多渠道集成 ​

• 全平台覆盖：支持飞书（Lark）、Discord、Slack、Microsoft Teams 等
• 单一网关：通过单个 Gateway 进程管理所有渠道
• 语音支持：支持 macOS/iOS/Android 语音交互
• 画布界面：可渲染交互式 Canvas 界面

自托管与数据安全 ​

• 完全自托管：运行在你自己的机器或服务器上
• 开源：MIT 协议，代码完全透明
• 本地数据存储：上下文与技能存储在本地，不上传云端

智能 Agent 能力 ​

• 持久运行：支持后台持久运行与持久记忆
• 定时任务：支持 cron 定时任务
• 会话隔离：按 Agent/工作区/发送者隔离会话
• 多 Agent 路由：支持多 Agent 协作
• 工具调用：原生支持工具调用与代码执行

安装 ​

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

npm install -g openclaw@latest

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build
pnpm run openclaw onboard

安装完成后运行引导向导（手动克隆方式已在上方命令中包含）：

openclaw onboard

配置 ​

配置文件位置 ​

OpenClaw 配置文件位于 ~/.openclaw/openclaw.json：

• macOS: /Users/你的用户名/.openclaw/openclaw.json
• Linux: /home/你的用户名/.openclaw/openclaw.json
• Windows: C:\Users\你的用户名\.openclaw\openclaw.json

如果文件不存在，请先创建：

mkdir -p ~/.openclaw
touch ~/.openclaw/openclaw.json

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.openclaw\openclaw.json"

配置文件结构 ​

openclaw.json 的整体结构分为两大部分：

{
  "models": {
    "mode": "merge",
    "providers": {
      // 配置 AI 模型提供商
    }
  },
  "agents": {
    "defaults": {
      // 配置默认模型、工作目录等
    }
  }
}

• models.providers — 定义服务提供商，包括地址、Key、模型列表
• models.mode — 设为 "merge" 时，自定义配置会与内置默认配置合并，强烈建议始终加上
• agents.defaults.model.primary — 默认使用的模型，格式��� provider名称/模型ID
• api — API 协议类型，Anthropic 模型用 "anthropic-messages"，OpenAI 兼容模型用 "openai-responses"

配置方式 ​

配置 Anthropic（Claude）模型 ​

将以下内容写入 openclaw.json：

{
  "models": {
    "mode": "merge",
    "providers": {
      "fishxcode-anthropic": {
        "baseUrl": "https://api.fishxcode.com",
        "apiKey": "sk-你的FishXCode-Token",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "fishxcode-anthropic/claude-opus-4-6"
      }
    }
  }
}

配置 OpenAI（GPT）模型 ​

通过 FishXCode 调用 OpenAI 模型时，api 字段须设为 openai-responses：

{
  "models": {
    "mode": "merge",
    "providers": {
      "fishxcode-openai": {
        "baseUrl": "https://api.fishxcode.com/v1",
        "apiKey": "sk-你的FishXCode-Token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "fishxcode-openai/gpt-5"
      }
    }
  }
}

同时配置 Anthropic + OpenAI（推荐） ​

在 models.providers 下并列添加两个 provider，即可同时使用两家模型：

{
  "models": {
    "mode": "merge",
    "providers": {
      "fishxcode-anthropic": {
        "baseUrl": "https://api.fishxcode.com",
        "apiKey": "sk-你的FishXCode-Token",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          },
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      },
      "fishxcode-openai": {
        "baseUrl": "https://api.fishxcode.com/v1",
        "apiKey": "sk-你的FishXCode-Token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          },
          {
            "id": "gpt-5-codex",
            "name": "GPT-5 Codex",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "fishxcode-anthropic/claude-opus-4-6",
        "fallbacks": [
          "fishxcode-anthropic/claude-sonnet-4-5-20250929",
          "fishxcode-openai/gpt-5"
        ]
      }
    }
  }
}

切换默认模型时，只需修改 model.primary 的值：

• "fishxcode-anthropic/claude-opus-4-6" → Claude Opus 4.6
• "fishxcode-anthropic/claude-sonnet-4-5-20250929" → Claude Sonnet 4.5
• "fishxcode-openai/gpt-5" → GPT-5
• "fishxcode-openai/gpt-5-codex" → GPT-5 Codex

关键字段说明 ​

| 字段 | 含义 | Anthropic（Claude） | OpenAI（GPT） | |

本页面介绍 FishXСоdе 的整体平台结构，帮助你快速定位所需功能。 需要注册账号？请查看 账户注册与管理。

一、平台概述 ​

FishXСоdе 是一个面向开发者和团队使用的 АI 接入平台。你可以把它理解成一个统一入口：前面是官网、定价和文档，后面是控制台、令牌、充值、发票和使用记录。

平台围绕主流 AI 模型提供中转服务，具体渠道和模型以官网实际为准，请前往 定价页 查看。用户从注册开始，到创建令牌、选择套餐、接入工具、查看消耗，整套流程都在同一个系统里完成。

生效日期：2026年2月11日

FishXCode 严格遵守《中华人民共和国个人信息保护法》、《网络安全法》、《数据安全法》及相关法律法规。

一、我们收集哪些信息及用途 ​

| 场景 | 收集内容 | 用途 | |

首次使用？请先完成 账户注册与充值，并在 FishXCode 控制台 获取 API Key。

一、确认接入参数 ​

QClaw 接入第三方大模型 API 时，优先使用 OpenAI Compatible 协议。即使调用的是 Claude 模型，也填写 OpenAI 兼容接口参数。

| 配置项 | 值 | |

在 VSCode 中安装 RooCode ​

1. 在 VSCode 中搜索 RooCode 并安装
2. 访问 https://fishxcode.com/console/token 获取你的 API Key

新增提供商 ​

完成 RooCode 安装后，打开 RooCode，选择配置提供商，新增一个 OpenAI Compatible 的供应商：

| 配置项 | 值 | |

首次使用？请先完成 账户注册与充值。

视频教程 ​

node -v
npm -v

brew install node

node -v
npm -v

这里列出 FishXCode 订阅套餐的入口、分类和扣费口径。价格、库存、限购、有效期和周期上限以定价页为准。

常用入口：

• 全部订阅套餐
• Claude 系列套餐
• Codex 系列套餐
• 按次系列套餐
• 站点计费规则与分组简介

一、套餐分类 ​

| 系列 | 入口 | 说明 | |

生效日期：2026年2月11日

1. 总则 ​

本协议由使用 FishXCode API 聚合平台（以下简称"提供方"、"FishXCode"或"公司"）服务的实体或个人（以下简称"用户"或"您"）与 FishXCode 共同缔结。本协议包括协议正文、隐私政策及其他相关政策和公告。您承诺具备完全民事行为能力（年满十八周岁）以订立本协议。若您代表某一法律实体，须保证拥有充分授权。

2. 定义 ​

| 术语 | 含义 | |

ZCF 是 Claude Code / Codex 的零配置增强工具，zcf init 一条命令完成 API 配置、工作流导入、MCP 服务集成等全部初始化。

没有账号？先完成 账户注册 获取 API Key。