配置 Agent 工具
用一条命令把 Codex、Claude Code、Gemini CLI、OpenClaw、OpenCode、Qwen Code、Crush、Factory Droid 、Kimi CLI、WorkBuddy 和 CodeBuddy 接入 ModelSell，并按各工具的最新配置方式写入。
modelsell configure 按各工具官方文档推荐的第三方模型接入方式写入配置。写入前会备份已有文件（后缀 .bak.<时间>），只改动 ModelSell 相关的部分，你自己的其他配置保持不变。
开始配置
交互式配置，按菜单选择一个或全部工具：
modelsell非交互配置，适合脚本和新机器初始化：
# 配置全部工具
modelsell configure --api-key sk-xxx --yes
# 只配置指定的工具，多个用逗号分隔
modelsell configure --target codex,claude --api-key sk-xxx --yes
# 为某个工具指定模型
modelsell configure --target qwen --qwen-model qwen3.7-plus --api-key sk-xxx --yes也可以用环境变量传入 Key：MODELSELL_API_KEY=sk-xxx modelsell configure --yes。配置完成后，重新启动对应工具即可生效。
支持的工具
| 工具 | --target | 写入的文件 | 接入方式 |
|---|---|---|---|
| Codex | codex | ~/.codex/config.toml | Responses API；Key 由 modelsell auth token 提供 |
| Claude Code | claude | ~/.claude/settings.json | Anthropic 协议；写入各档模型并开启 /model 模型发现 |
| Gemini CLI | gemini | ~/.gemini/settings.json、~/.gemini/.env | Gemini 原生协议 |
| OpenClaw | openclaw | ~/.openclaw/openclaw.json、~/.openclaw/.env | GPT、Claude、其他模型分别走各自协议 |
| OpenCode | opencode | ~/.config/opencode/opencode.json | OpenAI 兼容协议 |
| Qwen Code | qwen | ~/.qwen/settings.json | 加入 modelProviders，不影响已有的其他 provider |
| Crush | crush | ~/.config/crush/crushrc | 写入一段可重复替换的配置；Key 由 modelsell auth token 提供 |
| Factory Droid | droid | ~/.factory/settings.json | 写入 customModels；Key 由 apiKeyHelper 读取 |
| Kimi CLI | kimi | ~/.kimi/config.toml | 按协议写入 provider 和模型 |
| WorkBuddy | workbuddy | ~/.workbuddy/models.json | 加入自定义模型，保留已有模型，保存后自动生效（v0.5.0 起） |
| CodeBuddy | codebuddy | ~/.codebuddy/models.json | 同上（v0.5.0 起） |
OpenCode 已有 opencode.jsonc 时直接更新该文件。设置了 XDG_CONFIG_HOME 时，Crush 和 ModelSell 的配置目录随之变化。
办公类 Agent
WorkBuddy 支持自定义模型，可以一键配置。千问系的 QoderWork 和豆包、扣子目前只能使用内置模型，没有接入第三方模型的入口，因此无法配置。
默认模型怎么选
配置时 CLI 会读取 ModelSell 实时模型目录，并只在当前 Key 有权限的模型中推荐：
| 工具 | 推荐的默认模型 |
|---|---|
| Codex、OpenCode、Crush、Droid、OpenClaw、WorkBuddy、CodeBuddy | 最新的支持 Responses API 的 GPT 模型 |
| Claude Code | 最新的 Sonnet；Opus、Haiku、Fable 各档也会写入最新版本 |
| Gemini CLI | 最新的 Gemini Pro |
| Qwen Code | 最新的 Qwen 模型 |
| Kimi CLI | 最新的 Kimi 模型 |
目录暂时无法访问时使用内置默认值。交互模式下每个工具的模型都可以改，直接回车即采用推荐值。OpenClaw、OpenCode、Qwen Code、Crush、Droid、Kimi CLI、WorkBuddy 和 CodeBuddy 还会写入一组精选模型及其上下文长度，可在工具内切换。
Key 的保存方式
- Codex、Crush、Droid：配置文件里不保存 Key。工具需要 Key 时运行
modelsell auth token读取，Key 保存在~/.config/modelsell/credentials.json（权限 600）。请保持modelsell命令所在位置不变；移动或卸载后需重新配置。 - Claude Code、Gemini CLI、OpenClaw、OpenCode、Qwen Code、Kimi CLI、WorkBuddy、CodeBuddy：Key 写入上表中该工具自己的配置文件，这是这些工具读取 Key 的方式。不要把这些文件提交到代码仓库或分享给他人。
- 更换 Key 时重新运行一次
modelsell configure即可。
从旧版本升级
0.4.0 按各工具当前的配置方式调整了写入内容。用旧版本配置过的工具，升级后重新运行一次 modelsell configure 即可：
- Codex：旧版本把 Key 写进
~/.codex/auth.json，新版 Codex 对自定义模型服务不读取这个文件，请求会鉴权失败。新版本改用modelsell auth token，也不再改动auth.json中的 ChatGPT 登录。 - Claude Code：旧版本设置的
ANTHROPIC_MODEL会在每次启动时覆盖你在/model中的选择，重新配置时会移除它，改为写入model设置。 - OpenClaw：环境变量改为
MODELSELL_开头，避免影响 OpenClaw 自带的 OpenAI 配置；非 GPT 模型改走 Chat Completions。
各工具的手动配置
需要手动配置或了解某个工具的更多用法时，查看对应页面：
ModelSell CLI：模型调用与 Agent 配置
一键配置 Codex、Claude Code、Gemini CLI、OpenClaw、OpenCode、Qwen Code、Crush、Droid、Kimi CLI、WorkBuddy 和 CodeBuddy，并可在终端或 Agent 中调用全部模型。
AionUi
免费开源桌面办公 Agent，支持多模型、文件管理和实时预览。
AstrBot - Agent 聊天机器人
多平台聊天机器人与 Agent 框架，可接入 OpenAI 兼容模型服务。
CC Switch
一键管理 Claude、Codex、Gemini CLI 的 Provider、MCP 与提示词配置。
Cherry Studio
桌面 AI 助手客户端，支持多模型对话与多角色管理。
Claude Code
Anthropic Claude 驱动的终端代码助手，支持多文件协同编辑。
CodeBuddy
通过本地 JSON 模型配置接入 OpenAI 兼容接口的 AI 编程助手。
Codex CLI
命令行界面的 AI 代码助手，支持沙箱与补丁式编辑。
Gemini CLI
Google Gemini CLI，可通过 ModelSell CLI 一键写入 API Key、默认模型和 base URL。
Copilot CLI
通过 BYOK 模式接入自定义 OpenAI 兼容模型网关。
Crush
Charm 开发的开源终端 AI 编码智能体，拥有响应式 TUI。
Cursor
AI 原生代码编辑器，可通过自定义 Base URL 接入模型服务。
Factory Droid CLI
面向软件工程流程的 AI 助手，覆盖规划、开发与测试。
流畅阅读 (FluentRead) - 开源翻译插件
开源浏览器翻译插件，可接入兼容 OpenAI 的翻译模型。
Hermes Agent
Nous Research 出品的开源终端 AI Agent，可通过 Custom Endpoint 接入。
LangBot - 即时通信机器人开发平台
面向即时通信平台的开源机器人开发框架。
LunaTranslator - 开源 GalGame 翻译器
开源 GalGame 翻译器，可配置兼容 OpenAI 的翻译服务。
Memoh - 容器化 AI 智能体平台
容器化 AI 智能体平台，可接入自定义模型供应商。
nanobot
轻量级 AI 智能体，支持通过 config.json 快速接入模型服务。
Oh My Pi
终端 AI 编程 Agent，支持思考模式与深度推理等级映射配置。
OpenClaw
自托管 AI 助手平台，支持多渠道 AI 代理管理。
OpenCode
开源终端 AI 编程智能体，兼容多种模型服务供应商。
Pi
极简且高度可扩展的终端编码框架，支持自定义技能与模板。