工具接入
工具接入总览
把 Claude Code、Codex、opencode 等编程工具接入 LynShen。先看本页的对照表，再打开对应工具的页面。
本节说明如何在常用的编程 Agent 中使用 LynShen。每个工具一页，内容包括协议、配置文件位置、可复制的配置、模型选择、推理显示和常见错误。
准备工作
-
在令牌管理中为每个工具创建一个单独的 API 密钥。
-
用这个密钥查询可用模型：
curl https://api.lynshen.org/v1/models -H "Authorization: Bearer sk-..." -
记下要使用的模型 ID。下文配置中的
<模型ID>都要换成这里的值。
对照表
| 工具 | 推荐协议 | Base URL | 配置位置 |
|---|---|---|---|
| CC Switch | 按目标工具 | 按目标工具 | 图形界面 |
| Claude Code | Messages | https://api.lynshen.org | ~/.claude/settings.json |
| Codex | Responses（唯一） | https://api.lynshen.org/v1 | ~/.codex/config.toml |
| opencode | Chat、Responses 或 Messages | https://api.lynshen.org/v1 | ~/.config/opencode/opencode.json |
| oh-my-pi（omp） | Chat、Responses 或 Messages | https://api.lynshen.org/v1 | ~/.omp/agent/models.yml |
| pi | Chat、Responses 或 Messages | Chat/Responses 带 /v1，Messages 不带 | ~/.pi/agent/models.json |
| Hermes Agent | Chat、Responses 或 Messages | https://api.lynshen.org/v1 | ~/.hermes/config.yaml |
| OpenClaw | Chat、Responses 或 Messages | https://api.lynshen.org/v1 | ~/.openclaw/openclaw.json |
| ZCode | Messages、Chat 或 Responses | Chat/Responses 带 /v1 | 图形界面 |
| Kimi Code | Messages、Chat 或 Responses | Messages 不带 /v1，其他带 | ~/.kimi-code/config.toml |
| WorkBuddy | Chat Completions | https://api.lynshen.org/v1/chat/completions | 图形界面 |
选择协议
- 工具只支持一种协议时，使用那一种。例如 Codex 只支持 Responses。
- 工具支持多种协议时：
- 调用 Claude 模型，优先用 Messages。思考块和签名可以原样往返。
- 调用 GPT 模型，优先用 Responses。可以请求推理摘要。
- 调用国内模型（DeepSeek、GLM、Kimi、Qwen、MiniMax），优先用 Chat Completions。
- 网关会转换协议，所以其他组合也能工作。但部分功能可能丢失，例如通过 Messages 调用 GPT 时看不到推理摘要。
Base URL 规则
- 工具使用 OpenAI SDK 或拼接
/chat/completions、/responses时，填https://api.lynshen.org/v1。 - 工具使用 Anthropic SDK 或自己拼接
/v1/messages时，填https://api.lynshen.org。 - 部分工具会自动去掉或补上
/v1。各工具页面写明了它的行为。 - 网关同时接受
Authorization: Bearer和x-api-key。工具使用哪个请求头都可以。
推理显示的兼容性
LynShen 的流式 Chat Completions 默认把推理放在 delta.reasoning_details[] 中。有些工具只从 delta.reasoning_content 或 delta.reasoning 读取推理文字。这些工具通过 Chat Completions 调用模型时，可能看不到思考过程。回答本身不受影响。
| 工具的 Chat Completions 模式 | 能否显示 reasoning_details 中的推理 | 依据 |
|---|---|---|
| Hermes Agent | 能 | 源码读取 reasoning_details 中的文字 |
| OpenClaw | 部分：显示 reasoning.text，不显示 reasoning.summary | 源码 |
opencode（@ai-sdk/openai-compatible） | 不能 | AI SDK 源码只读取 reasoning_content 和 reasoning |
pi、oh-my-pi（openai-completions） | 不能，只显示空的思考块 | 源码把 reasoning_details 当作回传数据 |
Kimi Code（openai 类型） | 不能 | 源码跳过数组形式的字段 |
| ZCode（Chat completions 格式） | 不能 | 源码使用 @ai-sdk/openai-compatible |
| WorkBuddy | 未确认 | 官方文档没有说明，源码未公开 |
如果你需要看到思考过程：
- 调用 Claude 模型时，在工具中选择 Messages 协议。
- 调用 GPT 模型时，选择 Responses 协议，并请求推理摘要。
- 调用国内模型时，联系客服确认该模型是否已开启
reasoning_content兼容输出。开启后，流式 delta 中会同时出现reasoning_content。
通用排错
| 现象 | 检查 |
|---|---|
| 404 | Base URL 是否多了或少了 /v1。 |
| 401 | 密钥是否正确，环境变量是否在工具的进程中生效。 |
model_not_found | 模型 ID 是否与 /v1/models 完全一致。 |
| 工具一直转圈、没有输出 | 是否使用了 https://api.lynshen.org，是否开启了流式输出。 |
| 看不到思考过程 | 见各工具页面的“显示推理”一节和思维链（推理）。 |
各工具的配置方法在 2026-10-11 按官方文档和源码整理。工具更新后，配置方式可能变化。以工具的官方文档为准。