LoomCode Guide

使用文档

从创建密钥到接入 Codex CLI、Claude Code、Gemini CLI 和 OpenCode。这里保留最常用的步骤，详细配置仍以控制台“使用密钥”弹窗生成的内容为准。

快速开始

第一次接入建议按这个顺序完成，避免 Key 已创建但客户端配置不完整。

进入控制台

创建 API Key

在 API 密钥页创建 Key，并选择要使用的模型分组。创建成功后先保存明文 Key。

复制配置

点击“使用密钥”，选择 Codex CLI、Claude Code、Gemini CLI 或 OpenCode，复制对应配置。

重启客户端

写入配置后重启本地客户端，再发起一次简单请求确认链路可用。

控制台说明

控制台用于管理账号资产、Key、用量和订单，日常排查优先从这里开始。

总体数据

查看今日费用、Token、调用次数和本月使用量。

API 密钥

创建、复制、停用 Key，并进入使用密钥配置弹窗。

使用记录

按 Key、模型和时间查询调用明细。

渠道状态

检查当前账号可用渠道、延迟和模型窗口。

我的订阅

查看套餐状态，或前往定价页开通订阅。

我的订单

核对订单、充值和订阅记录。

API Key 使用

Key 创建成功后，弹窗会切换为成功状态，可以复制明文 Key 或直接进入“使用密钥”。

注意

明文 Key 只适合在创建后立即保存。后续列表中只显示 Key 预览值，如需重新查看完整 Key，请重新创建并替换客户端配置。

为不同设备或项目创建独立 Key，便于统计和停用。
Key 需要绑定分组，LoomCode 才能生成对应平台的配置。
发现异常用量时，先停用对应 Key，再到使用记录中核对来源。

Codex CLI 配置

OpenAI 兼容分组会生成 Codex CLI 配置，公共 API 入口默认为 https://api.loomcode.cn。

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.loomcode.cn"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-你的-LoomCode-Key"
}

其他客户端

不同分组会显示不同客户端配置，直接使用弹窗里的变量和值即可。

Claude Code

export ANTHROPIC_BASE_URL="https://api.loomcode.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的-LoomCode-Key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Gemini CLI

export GOOGLE_GEMINI_BASE_URL="https://api.loomcode.cn/v1beta"
export GEMINI_API_KEY="sk-你的-LoomCode-Key"
export GEMINI_MODEL="gemini-2.0-flash"

计费与排障

调用费用以控制台使用记录和套餐规则为准，排障时优先确认 Key、分组、余额和渠道状态。

请求失败：检查客户端 Base URL 是否与弹窗一致，Key 是否绑定正确分组。
模型不可用：查看渠道状态，确认账号当前是否拥有对应模型窗口。
费用异常：在使用记录中按 API Key 过滤，再按时间核对 Token 与入口。

model_provider = "OpenAI" model = "gpt-5.5" review_model = "gpt-5.5" disable_response_storage = true network_access = "enabled" [model_providers.OpenAI] name = "OpenAI" base_url = "https://api.loomcode.cn" wire_api = "responses" requires_openai_auth = true [features] goals = true