x-claude

x-claude 是一个面向 VS Code 的编码代理扩展，界面风格接近 Copilot Chat，但实现方式是干净重建的开源方案：侧边栏聊天面板、可切换模型配置、SecretStorage 私钥管理，以及面向工作区的本地工具调用循环。

作者：阿源，一个能硬拉220kg的AI开发工程师。

项目定位

• 交互和模式组织借鉴了你的 opencode 项目，并按 VS Code 侧边栏扩展形态做了适配。
• 默认适配 Kimi 的 OpenAI 兼容接口，也可切换到其他兼容服务。
• 重点是“代理调整”而不是“单纯对话”：扩展内置文件枚举、内容读取、文本搜索、写文件和精确替换工具，便于模型围绕代码库做分析和改写。

功能

• 侧边栏聊天界面，支持连续会话
• SecretStorage 保存私钥，不把私钥写入工程文件
• 保存密钥或模型配置后自动联网校验 API 地址、密钥和模型可用性
• 可在界面内直接调整 base URL、model、temperature，并支持折叠配置区
• 支持四种模式：Build、Plan、General、Explore
• 本地工具调用：列文件、读文件、搜索文本、写文件、精确补丁
• 会话历史持久化到工作区状态
• 回车直接发送，Shift+Enter 换行
• 自动改动后会显示已更改文件，并支持保留或撤销本轮改动
• 打包图标直接使用用户提供的 logo.jpg

使用方式

1. 在命令面板执行 x-Claude: Set API Key
2. 打开侧边栏中的 x-Claude
3. 检查顶部配置区，推荐使用 https://api.moonshot.cn/v1 和 kimi-k2.5
4. 保存配置后，扩展会自动联网校验密钥、地址和模型
5. 默认使用 Build 模式自动读取、修改并写回代码
6. 如需换行，使用 Shift+Enter
7. 修改后可在界面中查看已更改文件，并选择保留或撤销

默认配置：

• base URL: https://api.moonshot.cn/v1
• model: kimi-k2.5

连接校验

• 扩展会在保存密钥后自动请求 GET /v1/models
• 如果 base URL 缺少 /v1，会直接给出修正提示
• 如果密钥有效但模型不可用，会提示当前账号可见的模型示例

这一步能较快定位常见问题，例如：

• API Key 错误
• API 地址写错
• 模型名不存在
• 当前账号无该模型权限

模式

• Build：默认编辑模式，允许读取、搜索、写入和精确补丁。
• Plan：规划模式，只做分析和方案输出，不允许写文件。
• General：通用多步任务模式，适合较复杂的仓库改造和协同任务。
• Explore：快速检索模式，只做列文件、读取和搜索。

开发

npm install
npm run compile

调试时按 F5 启动 Extension Development Host。

打包

npm run package

这会在项目目录生成一个 .vsix 文件，便于本地安装和分发。

发布说明

真正发布到 VS Code Marketplace 还需要你自己的 publisher 账号和 access token。当前工程已具备打包条件，但没有发布凭证时无法替你直接执行上线。