Atomic Chat Launch页面实战：一键配置Claude Code、Codex等10+编程Agent跑本地模型

Atomic Chat 是一款本地 AI 应用与推理引擎，让你在电脑隐私地运行开源大模型。它的Launch 页面（Integrations 集成页）可以把 Claude Code、Codex CLI 等 20 多个编程 Agent 和编辑器一键指向本地模型——自动安装、写入配置、拉起终端，全程 100% 离线，代码不出本机。本文带你从零跑通这条"本地模型 + AI 编程 Agent"的黄金链路。

什么是 Launch 页面：本地模型与 AI Agent 的一键桥梁

传统用法中，你想让外部 Agent 用上本地模型，得手动改每个 Agent 的配置文件，把接口指向本地的 OpenAI 兼容服务，繁琐且容易出错。

Atomic Chat 的 Launch 页面把这件事压缩成了三个区块 + 一个按钮：

• Local API Server（本地 API 服务器）：为本地模型提供一个 OpenAI 兼容服务（默认端口1337，/v1前缀），所有 Agent 都指向它；
• Coding Agents（编程 Agent）：Claude Code、Codex CLI、OpenCode、Cline CLI、Copilot CLI、Zed、OpenHands、Goose 等 17 个可读写代码的终端 Agent；
• Assistants（助手类 Agent）：Atomic Agent、Hermes Agent、OpenClaw 等日常任务助手；
• Editors（编辑器）：VS Code、JetBrains、Xcode，支持一键复制连接参数并自动打开。

每个卡片实时显示Installed / Not installed状态（自动通过二进制探测识别，Windows 下还能识别 WSL 安装），让你一眼看清哪些工具已经就位。

三步上手：从加载模型到 Agent 开工

第 1 步：在聊天中加载一个本地模型

先在 Atomic Chat 的聊天里加载任意一个本地模型（Hub 中可下载）。这是前置条件——大多数编程 Agent 需要"当前正在运行的模型"作为后端。

第 2 步：打开 Launch 页面，点击 Run

进入左侧边栏的Integrations（Launch）页面。对任意一个 Agent 卡片点击Run按钮，页面会自动完成一条完整流水线：

1. 检测安装：探测该 Agent 是否已安装（未安装则自动拉起官方安装器，并实时流式显示安装日志）；
2. 启动本地服务器：若 Local API Server 未运行，自动先启动；
3. 写入配置：把 Agent 的配置文件指向本地服务器地址、模型名和 API Key（例如 Codex 写入~/.codex/config.toml，OpenCode 合并写入~/.config/opencode/opencode.json，已有配置不会被覆盖）；
4. 拉起终端：配置完成后自动打开终端并启动该 Agent，直接开聊开干。

第 3 步：直接下达任务

终端里已是配好本地后端的 Agent，例如对 Claude Code 说"帮我重构这个模块"，所有推理都在你的显卡上完成。

支持清单：Claude Code、Codex CLI 与 20+ Agent 总览

以Claude Code为例，页面支持为 Large / Medium / Small 三个档位分别指定本地模型，复杂推理用大模型、轻量任务用小模型，兼顾速度与能力；Codex CLI等则直接复用本地 OpenAI 兼容协议，无需任何额外协议转换。

编辑器接入：VS Code、JetBrains、Xcode 一键复制连接参数

GUI 编辑器把模型配置存在 IDE 自己的加密存储里，无法由程序代写配置。Launch 页面为它们提供了另一套"Enable"流程：

1. 点击Copy settings：自动复制Base URL（含/v1）、API key和当前模型名到剪贴板；
2. 点击Enable：先确保本地服务器在运行，再把 VS Code / JetBrains / Xcode 直接拉起；
3. 按卡片里展开的Manual setup步骤，把复制的参数粘贴进编辑器自身的模型设置即可。

实战技巧与常见问题

• "No model is running" 提示：说明还没加载本地模型，先在聊天里加载一个再点 Run 即可；
• 安装失败（网络/DNS 错误）：页面会给出明确提示——在 设置 → HTTPS Proxy 中配置代理后重试，npm/PowerShell 安装器通常不支持 SOCKS 代理；
• 自动检测不到已安装的 Agent：展开卡片的Set binary path，手动填入可执行文件路径（尤其适用于非标准安装位置）；
• 查看安装过程：安装期间卡片下方可展开Install log，实时滚动查看官方安装器的输出，排障一目了然；
• 终端方式同样可行：喜欢命令行的话，也可以直接用 CLI 一行命令拉起 Agent，例如jan launch claude --model <模型名>，详见 cli.mdx。

相关源码与文档路径

• 页面前端：web-app/src/routes/launch/index.tsx
• Agent 目录与配置元数据：web-app/src/constants/integrations.ts
• 安装/配置/检测的 Rust 命令实现：src-tauri/src/core/system/commands.rs
• 页面文案（含错误提示）：web-app/src/locales/en/launch.json
• Claude Code 集成文档：docs/src/pages/docs/desktop/integrations/claude-code.mdx
• 功能决策记录：2026-06-01 新增 Launch 页面

现在，打开 Atomic Chat 的 Launch 页面，挑一个你最顺手的编程 Agent，一次点击，让顶级 AI 编程能力在本地模型上私有离线地为你工作。🚀