使用本机 CLI 代理
安装、认证和扫描是三个步骤。OpenDesign 需要能找到并启动代理的可执行文件。
开始前
如果你已在本机使用代码代理，可以沿用它自己的登录和模型配置。
- 在对应代理的官方说明中完成安装。
- 先在终端打开该代理，完成登录，并确认能回答一个简单请求。
- 打开 OpenDesign →“设置”→“模型与提供商”→“本机 CLI”。
- 点击“重新扫描”，等待代理显示为已安装。
- 选择代理卡片，再选择模型。“默认”表示沿用该 CLI 自身的配置。
- 点击“测试”，确认代理能从 OpenDesign 启动，再等待自动保存成功。
本机 CLI 的主要登录路径在代理自身，不是 API 提供方面板。给 BYOK 填 Key，不会自动把所有本机代理都登录好。
已安装，却扫描不到
先确认终端能找到并运行该代理。macOS 从图标启动的应用，可能没有继承终端中的工具路径；仅在终端里可运行，不代表 OpenDesign 后台也能找到它。
重新打开应用后再扫描。若仍失败，按代理的安装文档检查工具路径；Codex 可在高级设置中指定可执行文件路径。使用 WSL 时，需确认 OpenDesign 与代理实际运行在同一套 Windows/WSL 环境，而非两套独立安装。
使用自定义代理地址或多账户配置
在“本机 CLI”中选择代理，展开“高级：代理与自定义路径”。普通官方登录用户可先保持这些字段为空。
| 代理 | 可配置项 | 用途 |
|---|---|---|
| Claude Code | CLAUDE_CONFIG_DIR | 指定另一套已登录的配置目录 |
| Claude Code | ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY | 使用该代理支持的自定义模型服务 |
| Codex | CODEX_HOME、CODEX_BIN | 指定配置目录或可执行文件 |
| Codex | OPENAI_BASE_URL、CODEX_API_KEY、OPENAI_API_KEY | 覆盖自定义接口或凭据 |
不要同时填写互相冲突的配置。以所选代理支持的认证方式为准；修改高级项后重新测试。这里的高级项只作用于所选 CLI，不替代其他代理的登录。
兼容性与推理强度
本机 Codex、OpenCode、DeepSeek Harness 等支持时，可在模型选择器调整推理强度；可选档位取决于 Agent、模型和提供商。客户端托管模型面板当前没有同样的可调入口，不能把外部 API 参数支持等同于客户端一定有开关。
当前支持答疑提示 OpenCode v2 尚未适配；如果更换主版本后无法启动，先核对兼容版本。Antigravity 在 Windows 长提示词场景也有已知启动问题；更新后仍失败，可先切换到其他可用 Agent，并按 诊断导出 提交复现信息。