工具配置教程

功能概览

本页用于说明工具配置教程的核心能力、调用入口和接入要点，帮助开发者快速判断适用场景并完成集成。

适用场景

产品原型验证：快速接入模型能力，验证内容生成、理解或编辑流程。
生产业务接入：用于批量任务、自动化工作流和多模型组合调用。
能力迁移适配：适合从原有模型或 SDK 平滑切换到亿速云AI统一接口。

接入建议

优先确认模型名称、请求路径和响应字段，再接入具体业务流程。
对异步任务、媒体生成和长耗时请求，建议在业务侧加入重试与状态轮询。
上线前建议准备日志追踪、错误兜底和内容安全校验，便于稳定运行。

macOS / Linux 配置方法

请确保配置目录存在。macOS / Linux 用户可运行以下命令创建目录：

mkdir -p ~/.codex

`~/.codex/config.toml`

复制以下内容到 ~/.codex/config.toml：

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

[model_providers.OpenAI]
name = "OpenAI"
base_url = "<YOUR_BASE_URL>"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

`~/.codex/auth.json`

复制以下内容到 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "<YOUR_API_KEY>"
}

Windows 配置方法

请确保以下内容位于 config.toml 文件的开头部分。

配置目录：

%userprofile%\.codex

按 Win + R，输入 %userprofile%\.codex 可打开配置目录。如目录不存在，请先手动创建。

`%userprofile%\.codex\config.toml`

复制以下内容到 %userprofile%\.codex\config.toml：

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

[model_providers.OpenAI]
name = "OpenAI"
base_url = "<YOUR_BASE_URL>"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

`%userprofile%\.codex\auth.json`

复制以下内容到 %userprofile%\.codex\auth.json：

{
  "OPENAI_API_KEY": "<YOUR_API_KEY>"
}

OpenCode 配置方法

配置文件路径：

~/.config/opencode/opencode.json

也可以使用：

~/.config/opencode/opencode.jsonc

如果配置文件不存在，需要手动创建。可以使用默认 provider，例如 openai、anthropic、google，也可以使用自定义 provider_id。

API Key 支持直接配置，也可以通过 OpenCode 客户端的 /connect 命令配置。以下示例仅供参考，模型与选项可按需调整。

`opencode.json`

复制以下内容到 opencode.json：

{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "<YOUR_BASE_URL_V1>",
        "apiKey": "<YOUR_API_KEY>"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5",
          "limit": {
            "context": 280000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        },
        "gpt-5.4": {
          "name": "GPT-5.4",
          "limit": {
            "context": 280000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini",
          "limit": {
            "context": 280000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        }
      }
    }
  },
  "agent": {
    "build": {
      "options": {
        "store": false
      }
    },
    "plan": {
      "options": {
        "store": false
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

配置检查

配置完成后，请确认：

config.toml 中的 base_url 已替换为真实接口地址
auth.json 中的 OPENAI_API_KEY 已替换为真实 API Key
OpenCode 配置中的 baseURL 已使用 OpenAI 兼容接口地址
OpenCode 配置中的 apiKey 已替换为真实 API Key，或已通过 /connect 配置