一人一器
  • 简体中文

    • Agent 接入

    Geekit 可以作为支持自定义 Provider 的 CLI、桌面 Agent 和开源客户端的统一模型入口。优先推荐 Codex CLI 和 Claude Code CLI：两者协议清晰、配置可审计，也最适合代码与复杂任务。

    核验日期：2026-07-27

    Geekit 中转接入：适用于无法直连官方模型服务的网络环境

    客户端本体仍应通过对应的官方教程安装或更新。安装完成后，按本章教程把 Base URL、API Key 和模型 ID 配置为 Geekit；后续模型请求将发送到 https://geekit.yryq.top，无需直接连接 OpenAI 或 Anthropic API，也不需要把上游密钥交给客户端。

    Geekit 中转的是模型请求，不提供客户端安装包镜像。官方安装地址在当前网络不可达时，请使用所在组织批准的软件镜像或离线安装包，不要从不明网盘下载可执行文件。

    第一步：先获取并配置连接参数
    • <Geekit 地址>：填写 https://geekit.yryq.top。
    • GEEKIT_API_KEY：变量名不要修改，变量值替换为生成的真实 Geekit 令牌，例如 sk-...。生成 API Key。
    • <Geekit 模型 ID>：使用账户当前可用的最新模型；Codex 推荐 gpt-5.6-sol，Claude 推荐 claude-opus-5。查看可用模型。

    将以下内容写入 ~/.zshrc（Zsh）或 ~/.bashrc（Bash）：

    export GEEKIT_BASE_URL="https://geekit.yryq.top"
export GEEKIT_API_KEY="<生成的真实 Geekit 令牌>"
export GEEKIT_MODEL="<Geekit 模型 ID>"

    保存后重新打开终端，或执行 source ~/.zshrc / source ~/.bashrc。PowerShell 使用用户级永久环境变量：

    [Environment]::SetEnvironmentVariable("GEEKIT_BASE_URL", "https://geekit.yryq.top", "User")
[Environment]::SetEnvironmentVariable("GEEKIT_API_KEY", "<生成的真实 Geekit 令牌>", "User")
[Environment]::SetEnvironmentVariable("GEEKIT_MODEL", "<Geekit 模型 ID>", "User")

    PowerShell 设置后需要关闭并重新打开。完整说明见快速开始。

    首选

    客户端Geekit 协议配置方式状态
    Codex CLIOpenAI Responses~/.codex/config.toml优先推荐
    Geekit++OpenAI Responses桌面 Provider 管理桌面增强工具
    Claude Code CLIAnthropic Messages环境变量、用户设置优先推荐
    CC Switch管理 Responses、Messages、Chat图形化 Provider 管理配置辅助工具

    常用 Agent

    客户端推荐协议状态
    OpenClawResponses 或 Chat已验证配置契约
    Hermes AgentChat、Responses 或 Messages已验证配置契约
    TRAE WorkChat 或 Messages桌面版已验证配置契约
    Tencent WorkBuddyChat Completions已验证配置契约
    QwenPawChat、Responses 或 Messages已验证配置契约
    LobsterAIChat 或 Messages已验证配置契约

    这里的“已验证”表示官方客户端支持自定义 Base URL 和 API Key，且协议与 Geekit 当前路由匹配；不表示已经使用你的真实令牌替你完成生产调用。

    配置前检查

    1. 确认 GEEKIT_API_KEY 已替换为 API Keys 页面生成的真实令牌。
    2. 从模型广场选择最新模型，或调用 /v1/models 复制真实模型 ID。
    3. 确认客户端要求根地址、/v1 Base URL，还是完整端点。
    4. 优先通过用户级永久环境变量或系统密钥管理器提供令牌。
    5. 使用一个最小任务验证流式响应、工具调用和 Geekit 日志。

    Base URL 对照

    协议填写值
    OpenAI Chat / Responseshttps://geekit.yryq.top/v1
    Anthropic Messageshttps://geekit.yryq.top
    Chat 完整端点https://geekit.yryq.top/v1/chat/completions
    Responses 完整端点https://geekit.yryq.top/v1/responses
    Messages 完整端点https://geekit.yryq.top/v1/messages

    地址重复出现 /v1/v1、客户端请求根路径或返回 404 时，优先检查这一项。

    兼容性边界

    ZCode、StepClaw、Coze 及自托管平台的公开证据不完整，或配置属于管理员能力。相关页面只说明已确认的边界，不提供无法复现的操作步骤。

    安全要求

    • 不要把真实令牌写入项目仓库或共享配置。
    • 不要在截图、录屏、日志和工单中显示令牌。
    • 本地 Agent 仍会把模型请求发往所配置的 Geekit 服务；“本地客户端”不等于“内容从不离开设备”。
    • 配置第三方工具前确认其密钥存储方式，不要假设所有客户端都加密保存 API Key。

    官方资料

    每个教程末尾列出对应产品的一手资料。客户端更新可能改变字段或界面；超过核验日期较久时，请先对照官方文档再修改配置。