官方网站： https://wk42worldworld.github.io/cybercode/
语言： English · 简体中文 · 日本語 · 한국어
她不是工具，她是伙伴。
She is not a tool. She is a partner.
彼女はツールではなく、パートナーです。
그녀는 도구가 아니라, 파트너입니다.
一个在 Claude Code 风格基础上扩展永久记忆与自进化能力 的本地可运行 Agent，支持接入任意 Anthropic 兼容 API（MiniMax、OpenRouter 等）。在完整 TUI 之外，还补全了 Computer Use（macOS / Windows）、打造了图形化桌面端，并支持通过 Telegram / 飞书完整远程驱动。
带有永久记忆与自进化能力的开源 Claude Code 风格桌面 Agent。
自带 CLI、桌面端、IM 远程控制、定时任务和 Computer Use；你可以接自己的模型，在本地跑真实编码会话。
安装 CLI · 为什么 · 对比 · 图形界面 · 功能 · 从源码运行 · 分章节教程 · 模块教程 · 环境变量 · 社区 · 更多文档
AI研究中心 QQ 群：463169230
扫码加入，交流使用心得、反馈问题和关注新功能。
curl -fsSL https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.sh | bashirm https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.ps1 | iex安装完成后，在任意项目目录启动 Agent：
cybercode安装器会自动获取最新稳定版；没有 Bun 时会自动安装，并把 cybercode 加入当前用户的 PATH。整个过程不需要管理员权限，更新时也会保留已有 CLI .env。执行前可以先查看 macOS/Linux 安装脚本 或 Windows 安装脚本。
| 命令 | 用途 |
|---|---|
cybercode |
在当前项目启动交互式 Agent |
cybercode "解释这个仓库" |
带一条初始任务启动 Agent |
cybercode -p "修复失败的测试" |
输出结果后退出，适合脚本和 CI |
cybercode -c |
继续当前项目最近一次会话 |
cybercode -r |
选择并恢复已保存的会话 |
cybercode --model <model> |
为当前会话指定模型 |
cybercode --permission-mode plan |
以规划模式启动 |
cybercode -p --output-format json "..." |
返回便于程序处理的 JSON |
cybercode -w feature-name |
为会话创建隔离的 Git worktree |
cybercode mcp --help |
配置和管理 MCP 服务器 |
cybercode plugin --help |
安装和管理插件 |
cybercode doctor / cybercode --help |
诊断运行环境或查看全部选项 |
更多示例和参数组合请查看 CLI 快速开始。
需要图形界面？可以直接下载 macOS、Windows 或 Linux 桌面端。
| 如果你想要... | CyberCode 提供... |
|---|---|
| Claude Code 风格 Agent，但不想被单一供应商绑定 | Anthropic 兼容端点、OpenAI 兼容供应商代理接入、供应商/模型上下文窗口元数据 |
| 不只在终端里用，而是有桌面端 | Tauri + React GUI、多会话标签、项目切换、文件附件、权限弹窗、模型/供应商设置 |
| 本地 Agent 能在你离开时继续工作 | Telegram / 飞书远程控制、定时任务、后台 Agent、跨会话记忆 |
| 一个能研究高级 Agent 能力的开源项目 | 多 Agent 编排、Skills、MCP、Computer Use、自定义供应商、CLI 无头模式 |
CyberCode 会从长期协作中提炼稳定的沟通偏好、项目知识和跨任务做事方法，让新会话不必每次从零开始。重复验证有效的工作方式还可以沉淀为 Skill 候选，逐步形成更适合你的执行习惯。
这些认知并不是不可见的黑箱。桌面端会展示「CyberCode 对你的了解」与「已提炼的做事方法」，注明来源和分类；每条内容都可以编辑或删除，底层记忆文件和学习记录也由用户自己掌控。
大型仓库、冗长命令输出、重复系统提示和过期工具结果都会挤占模型上下文。CyberCode 将 Lite 基础清理、智能裁剪、懒程序员策略、Caveman 响应压缩、RTK 工具输出压缩和代码图谱拆成可独立控制的优化层，用户可以按需全局开启或关闭。
面板会显示每层当前状态、作用范围和组合后的预估节省区间。这里展示的是透明的估算，不会把估算包装成保证发生的账单降幅。
本地代码图谱会索引文件、符号、引用、调用和包含关系。对涉及代码结构的任务，CyberCode 会在大范围读取文件前自动提供经图排序的精简上下文，并向正在运行的 Agent 提供更深入的图谱工具。这能减少在陌生仓库中逐文件试探，适合实现定位、影响分析和跨文件重构。
点击桌面端右侧栏的图谱图标，可以直接进入「知识空间」。图谱视图支持符号搜索、架构 / 文件布局、节点详情、拖动缩放与重建索引；「文件」和「搜索」视图还可以管理用户自己添加的本地文件或文件夹，支持拖放、全文搜索和二进制文件元数据索引。移除来源只会删除 CyberCode 生成的索引，不会删除原文件。
代码图谱全程在本地运行并支持四个桌面平台。全局开关开启后，当前及之后打开的项目都会自动建立索引，代码变化也会被后台监听；普通闲聊不会无意义地注入图谱上下文。查看知识空间与代码图谱使用教程。
无论选择 Claude 官方路径、Anthropic 兼容接口、OpenAI 兼容供应商还是本地端点，桌面工作流、工具与记忆能力都保持一致。对于原生联网能力不稳定的模型，CyberCode 还提供与模型厂商无关的本地 WebSearch 兜底，支持实时搜索、域名过滤、缓存和 GitHub Trending 直连抓取，避免模型只能依赖过期训练知识。
 在应用内管理供应商 配置云端或本地接口、测试连接并设置默认供应商，不必离开桌面工作流。 |
 每个会话自由选择模型 选择已知模型或填写自定义模型标识，同时保留相同的 Agent 工具与界面。 |
大模型与路由配置现在把“自定义提供商”作为独立入口放在最前面，方便直接接入任意兼容端点；随后依次是官方 API Key、大型聚合站、OAuth、网页会话、图像/视频/音频与本地模型。自定义端点和本地推理服务不再混在同一组。卡片名称跟随界面语言显示；同一套已保存 Key 可以聚合管理，但 Kimi Code 与 Kimi 这类不同产品仍保留独立入口。
支持兼容 /models 接口的提供商可以一键导入最新模型，也可以开启约每 24 小时运行一次的自动同步；同步会保留用户手动填写的模型。智能体路由会把多个可用目标组成带健康检查、失败冷却和自动切换的模型链。Agent 节点则把这些模型和路由安全地暴露为 OpenAI Chat Completions 与 Anthropic Messages 接口，外部 Agent 只拿独立的 cc_... 节点密钥，不会接触原始供应商 Key。
网页会话使用用户主动提供的 Cookie 或网页令牌，不读取浏览器数据、不代过验证码，也不绕过账号或地区限制；它的稳定性和服务条款风险高于官方 API。媒体目录优先展示中国提供商，连接测试不会触发付费生成，媒体模型也不会被误设为聊天默认模型。
桌面端与终端 TUI 共用这套配置。TUI 可直接使用 /provider sync、/routing 和 /node，无需额外安装代理。查看模型同步、智能体路由与节点教程。
React + Tauri 桌面端和 Ink 终端界面共享同一个本地 Agent 核心。文件附件、反斜杠命令、权限控制、MCP、Skills、插件、后台 Agent、Agent Teams、Git worktree、Computer Use 与无头输出都属于同一套工作流，而不是彼此割裂的产品。
Telegram 和飞书适配器可以在用户离开电脑后继续传递会话与权限请求。定时任务则支持一次性或周期性的本地工作，让仓库维护和例行检查不必等待手动打开聊天窗口。
CyberCode 将客户端、服务端、桌面壳、适配器、记忆、搜索、供应商桥接和优化逻辑全部开放。统一的数据迁移页可以检查其他本地 Agent 中兼容的 Skills、记忆、规则与项目资料，也能把配置、凭据、项目和四个平台的便携应用制作到 U 盘。便携项目路径会在不同系统和盘符之间自动映射，降低换工具、换电脑或临时离线工作时丢失积累的成本。查看数据迁移与 U 盘教程。
| 领域 | 已包含能力 |
|---|---|
| 编码工作流 | 文件编辑、终端工具、项目搜索、权限模式、反斜杠命令、附件、回退、分支与会话恢复 |
| Agent 智能 | 永久记忆、自进化复盘、可复用 Skills、子 Agent、Agent Teams、后台任务与 worktree |
| 上下文效率 | 动态上下文窗口感知、自动压缩、Lite 清理、智能裁剪、懒程序员、Caveman、RTK 与代码图谱 |
| 模型接入 | 官方 API Key、聚合站、OAuth、网页会话、媒体目录、本地/自定义端点、模型同步、智能体路由与 Agent 节点 |
| 联网与工具 | 与供应商无关的 WebSearch 兜底、WebFetch、MCP、插件、Computer Use 与环境感知工具可用性 |
| 使用界面 | 跨平台桌面端、终端 TUI、--print 无头模式、Telegram 与飞书 |
| 自动化 | 一次性和周期性定时任务、远程授权、后台 Agent 与机器可读 JSON 输出 |
| 可迁移性 | Agent 数据迁移、四平台 U 盘便携迁移、跨系统项目路径映射、可编辑本地记忆与开放适配器 |
| 需求 | CyberCode | Claude Code | Cursor / Cline / Roo 类工具 |
|---|---|---|---|
| 自带供应商配置 | 围绕自定义供应商和 Anthropic 兼容接口设计 | 主要是官方 Anthropic 路径 | 视工具而定 |
| 桌面 GUI | 内置跨平台桌面端 | 终端优先 | 通常编辑器优先 |
| CLI 和无头模式 | 支持 | 支持 | 通常不是主路径 |
| IM 远程控制 | Telegram / 飞书 adapters | 不是默认工作流 | 通常需要外部方案 |
| 定时编码任务 | 集成到桌面端工作流 | 不是默认工作流 | 视工具而定 |
| Computer Use | 支持 macOS 和 Windows | 官方功能路径 | 视工具而定 |
| 开源可改造 | 仓库包含桌面端、服务端、适配器和文档 | 闭源产品 | 视工具而定 |
CyberCode 桌面端把核心编码工作流放在一个界面里：选择项目、和 Agent 对话、配置供应商、切换模型、创建定时任务，都可以直接在 GUI 内完成。
 项目聊天工作区 支持多会话桌面聊天、紧凑输入框、文件附件入口、供应商/模型选择，并保留项目上下文。 |
按供应商选择模型 每个供应商既能手动填写自定义模型名，也能从按新到旧整理的模型下拉选项里选择。 |
内置供应商列表 内置 OpenAI、Google、DeepSeek、Kimi、MiniMax、GLM、OpenRouter、Claude 兼容端点等常见供应商入口。 |
定时编码任务 可以创建一次性或周期性的自动化任务，让本地 Agent 在你离开时继续处理工作。 |
- 新贡献者可以先看 CONTRIBUTING.md 和 Roadmap。
- 想帮忙传播，可以直接使用 Launch Kit 里的发布文案。
- 适合新手贡献的方向：文档、供应商预设、翻译、可复现 bug 报告、桌面端交互打磨、不同平台安装说明。
最新稳定桌面版：查看 GitHub Releases
- 运行中输入缓存与引导：AI 正在答复时再次发送内容，会先进入待处理提示条；用户可以编辑、删除、加入当前任务；如果继续排队，本轮结束后会自动作为下一轮发送。
- 模型上下文窗口感知：模型预设现在可以携带 context window 元数据，桌面会把这些限制传入会话，让第三方模型长上下文行为更稳定。
- 四平台桌面端发布：GitHub Actions 现在会同时发布 macOS Apple Silicon、macOS Intel、Windows x64、Linux x64，并生成
latest.json更新元数据。 - macOS 安装包已公证：macOS 桌面端包已完成签名和 Apple notarization，正常安装时不再触发之前那类“可能是恶意软件”的 Gatekeeper 提示。
- Windows 工具运行时兜底：CyberCode 会优先寻找 Git Bash，找不到就自动回退到 PowerShell，并且只把当前环境真正可执行的工具暴露给模型。
- 文件上传更灵活：遇到模型不直接支持的音频、二进制或其他文件类型时，会按文件路径传递，避免请求被卡住。
- 命令执行状态更清晰：正在运行的命令块会在父级命令行和子级工具行同时展示 GPT 风格的文字高光横扫效果。
- 模型接入与路由闭环：官方 Key、聚合站、OAuth、网页会话和媒体目录统一管理；支持模型同步、健康感知路由，以及可供其他 Agent 使用的 OpenAI/Anthropic 双协议节点。
- 统一数据迁移与 U 盘便携模式：在同一页面迁移 Agent 的 Skills、记忆和规则，或制作包含配置、项目与四平台应用的便携工作盘；Windows、macOS 与 Linux 之间会自动映射已迁移项目路径。
- 完整的 Ink TUI 交互界面（与官方 Claude Code 一致）
--print无头模式（脚本/CI 场景）- 支持 MCP 服务器、插件、Skills
- 支持自定义 API 端点和模型（第三方模型使用指南）
- AI 运行中再次输入时支持待处理提示条、编辑、删除和加入当前任务
- 模型/供应商上下文窗口元数据，让长上下文会话更可靠
- 工具运行时会按当前环境兜底，包括 Windows 上的 Git Bash / PowerShell 自动切换
- 桌面端上传不支持的文件类型时会自动按文件路径传给模型
- 命令执行块支持运行中高光进度效果
- 记忆系统（跨会话持久化记忆）— 使用指南
- 多 Agent 系统（多代理编排、并行任务、Teams 协作）— 使用指南 | 实现原理
- Skills 系统（可扩展能力插件、自定义工作流）— 使用指南 | 实现原理
- Channel 系统（通过 Telegram/飞书/Discord 等 IM 远程控制 Agent）— 架构解析
- Computer Use 桌面控制 — 功能指南 | 架构解析
- 数据迁移与 U 盘便携模式 — 使用教程
- 桌面端（Tauri 2 + React 图形化客户端，多标签多会话）— 文档
- 降级 Recovery CLI 模式（
CYBERCODE_FORCE_RECOVERY_CLI=1 ./bin/cybercode）
 整体架构 |
 请求生命周期 |
 工具系统 |
 多 Agent 架构 |
 终端 UI |
 权限与安全 |
 服务层 |
 状态与数据流 |
下面的步骤适用于开发或直接运行仓库源码。日常使用 CLI，建议优先使用上面的一行安装命令。
# macOS / Linux
curl -fsSL https://bun.sh/install | bash
# macOS (Homebrew)
brew install bun
# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"精简版 Linux 如提示
unzip is required，先运行apt update && apt install -y unzip
bun install
cp .env.example .env
# 编辑 .env 填入你的 API Key，详见 docs/guide/env-vars.md./bin/cybercode # 交互 TUI 模式
./bin/cybercode -p "your prompt here" # 无头模式
./bin/cybercode --help # 查看所有选项推荐安装 Git for Windows 以获得 Bash 兼容命令体验。如果没有 Git Bash，CyberCode 会自动回退到 PowerShell。
# PowerShell / cmd 直接调用 Bun
bun --env-file=.env ./src/entrypoints/cli.tsx
# 或在可用时通过 Git Bash 运行
./bin/cybercode将 bin/ 加入 PATH 后可在任意目录启动，详见 全局使用指南：
export PATH="$HOME/path/to/cybercode/bin:$PATH"如果你在开发或测试 desktop/ 前端，需要同时启动 API 服务端和桌面前端。
cd /path/to/cybercode
SERVER_PORT=3456 bun run src/server/index.ts可选自检：
curl http://127.0.0.1:3456/healthcd /path/to/cybercode/desktop
bun run dev --host 127.0.0.1 --port 2024然后在浏览器打开：
http://127.0.0.1:2024
- 如果
3456端口已经被旧服务端占用，先执行lsof -nP -iTCP:3456 -sTCP:LISTEN找到 PID，再kill <PID>。 - 测试聊天时建议新建一个 session，并重新选择一个真实存在的工作目录。
- 如果某个旧 session 绑定的目录已被删除，服务端会返回
Working directory does not exist，这和服务端是否启动是两回事。
第一次使用 CyberCode 时，可以按下面章节一步一步走。每章最后都有“完成结果”，方便确认当前步骤是否成功。
CyberCode 常见有三种使用方式：
| 方式 | 适合场景 | 你需要做什么 |
|---|---|---|
| 桌面端 App | 日常编码、多会话聊天、可视化切换项目 | 从 GitHub Releases 下载最新安装包 |
| 源码 CLI | 喜欢终端、需要本地开发、脚本化调用 | 克隆仓库，安装 Bun，然后执行 bun install |
| 桌面端开发模式 | 调试 React/Tauri 前端源码 | 按 桌面端联调 同时启动 API 服务和 Vite 前端 |
完成结果：你已经明确自己要安装桌面端、运行 CLI，还是调试桌面端前端。
CyberCode 使用 Anthropic 兼容接口。MiniMax、OpenRouter 等如果提供兼容端点，可以直接使用；只有 OpenAI 协议的供应商通常需要通过 LiteLLM 这类代理转换。
- 在模型供应商控制台创建或复制 API Key。
- 复制示例环境变量文件：
cp .env.example .env- 编辑
.env，至少填写：
ANTHROPIC_AUTH_TOKEN=your_api_key_here
ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
ANTHROPIC_MODEL=MiniMax-M2.7如果供应商要求使用 x-api-key 头，也可以把 ANTHROPIC_AUTH_TOKEN 换成 ANTHROPIC_API_KEY。更多供应商示例见 环境变量 和 第三方模型。
完成结果：.env 里已经有可用的 Key、接口地址和模型名。
先启动交互式终端界面：
./bin/cybercode建议先发一个小任务，例如：
阅读这个项目，并总结主要入口文件。
如果是脚本或 CI 场景，可以使用无头模式：
./bin/cybercode -p "总结 package.json，并列出可用 scripts"完成结果：CyberCode 能连接到模型供应商，并在终端里流式输出回答。
CyberCode 最适合在需要修改的项目目录里工作。
- 在项目根目录启动 CyberCode，或在桌面端选择项目文件夹。
- 先让它做一个小范围检查：
解释 src/ 目录结构。 - 当 CyberCode 请求运行命令或编辑文件权限时，先看清楚动作，只批准你信任的操作。
- 第一轮成功后，再提出更聚焦的任务，例如：
修复这个文件里的失败测试。
完成结果：助手已经在正确目录工作，你也能看见它准备使用哪些文件和命令。
如果使用已安装桌面端，直接打开 CyberCode 并为项目创建会话即可。如果是本地前端开发，先运行：
SERVER_PORT=3456 bun run src/server/index.ts再打开另一个终端：
cd desktop
bun run dev --host 127.0.0.1 --port 2024访问 http://127.0.0.1:2024，创建或选择会话，然后绑定真实存在的工作目录。
几个实用习惯：
- AI 正在回复时继续输入，新内容会进入待处理输入行。
- 待处理输入在发送前可以编辑或删除。
- 当前 AI 回复结束后，排队的待处理输入会自动作为下一轮用户消息发送。
- 如果某类文件不能直接发给模型，桌面端会按文件路径传递，让 Agent 仍然可以处理。
完成结果：你可以连续多轮编码，不会丢失 AI 忙碌期间输入的消息。
把仓库的 bin/ 目录加入 PATH：
export PATH="$HOME/path/to/cybercode/bin:$PATH"然后在另一个项目目录测试：
cybercode --help
cybercode -p "当前目录有哪些文件？"如果想永久生效，把 export PATH=... 这一行加入 ~/.zshrc 或 ~/.bashrc。
完成结果：你可以在任意项目目录直接运行 cybercode。
| 问题 | 检查方式 |
|---|---|
command not found: cybercode |
在仓库内用 ./bin/cybercode，或把 bin/ 加入 PATH |
| API Key 或 401 错误 | 重新检查 ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL 和模型名 |
| Windows 命令执行失败 | 安装 Git for Windows，或让 CyberCode 自动回退到 PowerShell |
| 桌面端连不上服务 | 确认服务端运行在 127.0.0.1:3456 |
3456 端口被占用 |
用 lsof -nP -iTCP:3456 -sTCP:LISTEN 找到旧进程，再执行 kill <PID> |
Working directory does not exist |
为当前会话重新选择一个真实存在的项目目录 |
| 长提示词异常失败 | 选择上下文窗口足够大的模型/供应商，或更新模型配置里的上下文元数据 |
完成结果：你能判断问题属于终端环境、API 配置、服务启动，还是项目路径选择。
| 目标 | 继续阅读 |
|---|---|
| 接入 OpenAI、DeepSeek、Ollama 或其他供应商 | 第三方模型 |
| 配置全部环境变量 | 环境变量 |
| 在任意目录启动 CyberCode | 全局使用 |
| 使用跨会话记忆 | 记忆系统 |
| 使用多个 Agent 协作 | 多 Agent 系统 |
| 接入 Telegram 或飞书 | Channel 系统 |
| 控制桌面应用 | Computer Use |
| 迁移 Agent 数据或制作便携工作盘 | 数据迁移与 U 盘便携模式 |
完成结果：你可以从第一个可用会话，自然进入自己真正需要的功能模块。
这一节是按功能模块拆开的使用手册。你已经能启动 CyberCode 后，可以按自己的需求逐个模块查看。
如果你想使用正常图形界面，而不是从源码启动，就看这一节。
- 打开 GitHub Releases。
- 按平台下载对应安装包：
- macOS Apple Silicon：
macos_arm64_dmg.dmg - macOS Intel：
macos_x64_dmg.dmg - Windows x64：
windows_x64_nsis.exe - Linux x64：
linux_x64_deb.deb
- macOS Apple Silicon：
- 使用系统默认安装方式安装。
- 启动 CyberCode，创建新会话。
- 发送第一条编码请求前，先选择一个真实存在的项目目录。
验证结果：应用能打开，左侧能看到会话列表，底部状态栏能看到当前项目和模型。
注意事项：
- macOS 安装包已经公证；如果仍被系统拦截，参考 安装指南。
- Release 中也会包含
latest.json，用于桌面端更新元数据。
如果你要接入 MiniMax、OpenRouter、通过代理接 OpenAI、Ollama 或其他兼容供应商，就看这一节。
- 打开桌面端。
- 进入设置 -> Providers。
- 选择一个预设，或添加自定义供应商。
- 填写：
- 供应商名称
- API Key
- Base URL
- API 协议：
Anthropic、OpenAI Chat或OpenAI Responses - 模型映射：
main、haiku、sonnet、opus
- 如果知道模型最大上下文，填写上下文窗口，例如
200k或1m。 - 点击测试连接。
- 激活该供应商。
- 点击底部状态栏的模型名称，为当前会话选择模型。
验证结果：发送一条短消息后，打开 /context 或上下文面板，确认当前模型和上下文上限符合预期。
注意事项：
- Anthropic 兼容接口可以直接填写供应商 URL。
- 只有 OpenAI 协议的接口通常需要 LiteLLM 等代理转换，详见 第三方模型。
- 如果模型名里包含
200k或1m这类明显标记，CyberCode 可以推断上下文窗口；但显式配置更可靠。
如果你偏好终端、自动化脚本或 CI，就看这一节。
- 安装依赖：
bun install- 创建环境变量文件：
cp .env.example .env- 编辑
.env，填入供应商配置。 - 启动交互式 TUI：
./bin/cybercode- 执行一次性提示词：
./bin/cybercode -p "解释这个仓库的结构"- 查看所有参数：
./bin/cybercode --help验证结果：交互模式能打开，-p 模式能直接输出完整回答，不进入 TUI。
注意事项：
- Windows 推荐安装 Git Bash；如果没有，CyberCode 会自动回退到 PowerShell。
- 如果想在任意目录运行
cybercode，把仓库的bin/加入 PATH。
如果你要同时管理多个真实项目或多个任务，就看这一节。
- 点击左侧
+，或按Cmd/Ctrl + N。 - 选择项目工作目录。
- 先发送一个小范围检查任务，例如：
解释这个项目结构。 - 使用左侧项目筛选器，只显示某个项目的会话。
- 使用侧边栏搜索，按标题查找旧会话。
- 右键会话，可以重命名或删除。
- 多个任务并行时，打开多个标签页。
- 右键标签页，可以关闭当前、关闭其他、关闭左侧、关闭右侧或关闭全部。
验证结果：每个会话都绑定到正确项目路径，底部状态栏展示当前项目和模型。
注意事项：
- 关闭正在运行的标签页时，会提示继续运行、停止并关闭或取消。
- 如果会话绑定的目录已经删除，需要重新选择真实存在的文件夹。
如果你要发更复杂的消息，或在 AI 忙碌时继续输入，就看这一节。
- 在底部输入框输入内容。
- 按
Enter发送，按Shift + Enter换行。 - 通过粘贴、拖拽或
+文件选择器添加附件。 - 输入
/打开斜杠命令，例如/status、/context、/memory、/mcp、/skills。 - 输入
@搜索并引用项目文件。 - AI 正在回复时继续发送消息，新消息会进入待处理输入行。
- 待处理输入发送前可以编辑或删除。
- 当前 AI 回复结束后，排队输入会自动作为下一轮用户消息发送。
- 需要中断时，点击停止按钮或按
Cmd/Ctrl + .。
验证结果：附件显示在输入框上方，斜杠命令打开对应面板或命令，@ 能解析到文件，AI 忙碌时输入的消息不会丢。
注意事项：
- 不支持直接传给模型的文件类型，会按文件路径传递，Agent 仍可通过工具读取。
- 待处理输入行只展示真实排队内容，不再显示无意义提示文字。
只要 CyberCode 要执行 Shell 命令或修改文件，就应该理解这一节。
- 在不熟悉的仓库里，保持默认询问权限模式。
- 每次权限卡片弹出时，先看清楚内容。
- 只想允许本次操作，点允许。
- 确定当前会话里同类操作都可信，再点一直允许。
- 命令、文件路径或 diff 看起来不对时，点拒绝。
- 只想看方案、不想执行时，切换到计划模式。
- 只在一次性环境或完全信任环境里使用绕过权限。
验证结果：文件编辑和 Shell 命令只会在权限策略允许后执行。
注意事项：
- 权限卡片会展示工具类型、命令或文件预览，以及可展开的详细参数。
- IM 远程控制里，权限请求也会以按钮卡片形式展示。
如果你希望 CyberCode 跨会话记住偏好、项目规则或外部引用，就看这一节。
- 正常对话即可，CyberCode 会在合适时机自动提取有价值记忆。
- 想显式保存时，直接说：
记住这个：...。 - 输入
/memory，打开可编辑的记忆文件。 - 输入
/remember，审查、提升、合并或清理自动记忆。 - 某条记忆过期时，让 CyberCode 忘记它。
- 想要干净回答时，说：
本轮忽略记忆。
验证结果：出现记忆更新通知，后续会话能使用保存过的偏好或项目上下文。
适合保存的记忆：
- 测试必须使用真实数据库，不要 mock。
- 某个日期开始进入发布冻结。
- 仪表盘、工单队列、on-call 信息在外部系统里。
注意事项：
- 记忆应该保存无法从代码中推断出来的上下文。
- 可通过
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1禁用自动记忆。
如果任务很大，需要并行探索、规划或独立验证，就看这一节。
- 让 CyberCode 拆分任务，例如：
先并行探索前端、后端和测试，再给我实现计划。 - 代码库调研使用 Explore agent。
- 架构方案和实现步骤使用 Plan agent。
- 改动完成后，用 verification agent 做独立验证。
- 耗时任务可以要求后台 agent。
- 实验性实现可以要求 worktree 隔离，避免影响主工作区。
- 协作型任务可以让 CyberCode 创建 Agent Team，并给不同成员分工。
验证结果：CyberCode 会报告 agent 启动、后台任务完成、验证结果或团队总结。
注意事项：
- 每个 agent 的任务要尽量聚焦。
- 面对大范围或高风险修改，先用 verification agent 再做最终确认。
如果你想把重复工作沉淀成可复用能力，就看这一节。
- 输入
/浏览当前可用命令。 - 先尝试内置 Skills，例如
/verify、/debug、/simplify、/remember、/batch。 - 在桌面端输入
/skills，查看当前上下文可由用户调用的 Skills。 - 项目级 Skill 可创建在
.claude/skills/<skill-name>/SKILL.md。 - 在 frontmatter 中填写
description、when_to_use、allowed-tools、model、paths等字段。 - 在 frontmatter 下方用 Markdown 写清楚工作流。
- 通过
/skill-name调用，或用自然语言提出明显符合when_to_use的任务。 - 如果需要外部工具或外部 prompt，把 MCP server 接入 CyberCode。
验证结果：Skill 能在斜杠命令里出现，或在匹配任务时被模型自动调用。
注意事项：
- 用
allowed-tools限制强能力 Skill 的工具范围。 - 项目级 Skills 可以放进仓库，适合团队共享流程。
如果你想在手机或团队聊天工具里远程控制 CyberCode，就看这一节。
- 打开桌面端设置。
- 进入 IM 或 Adapters 配置区。
- 填写
serverUrl，如果希望新聊天默认进入某个项目，也填写默认项目目录。 - 填写平台凭据：
- Telegram：Bot Token
- 飞书：App ID 和 App Secret
- 需要时配置允许用户。
- 生成 6 位配对码。
- 启动 adapter 进程：
cd adapters
bun install
bun run telegram
# 或
bun run feishu- 在 IM 私聊里把配对码发给 Bot。
- 配对成功后，直接发送正常编码请求。
- 需要时使用
/new、/projects、/stop。
验证结果：Bot 能连接到 CyberCode 会话，能流式回复，并用按钮展示权限请求。
注意事项：
- 配对码一次性使用，60 分钟后过期。
- 如果没有默认项目，Bot 会让你从最近项目中选择。
如果你希望 CyberCode 按计划自动执行某个 prompt，就看这一节。
- 打开桌面端。
- 点击左侧时钟图标。
- 点击新建任务。
- 填写任务名称和提示词。
- 设置 Cron 表达式，或使用星期/时间可视化控件。
- 选择运行时模型和权限模式。
- 保存任务。
- 用启用开关控制任务是否运行。
- 点击立即运行，先手动测试一次。
- 展开运行历史，查看以前的结果。
验证结果：任务列表中能看到人类可读的执行计划，手动运行后会生成历史记录。
注意事项：
- 定时任务依赖桌面端和本地服务可用。
- 无人值守任务建议使用保守权限模式。
如果你希望模型通过截图、鼠标和键盘操作桌面应用，就看这一节。
- 桌面端打开「设置 → Computer Use」，点击「自动准备」。
- CyberCode 会在后台下载当前平台的专用运行组件，无需安装 Python 或修改系统环境。
- macOS 上需要给 CyberCode、终端或桌面端宿主授权辅助功能和屏幕录制。
- 先发一个可观察的小任务，例如：
截屏看看现在打开了什么。 - CyberCode 请求应用访问权限时，按需批准。
- 让模型按步骤截图、分析、点击、输入并确认结果。
验证结果：CyberCode 能截屏、请求应用访问权限，并且只操作已批准的应用。
注意事项：
- macOS Apple Silicon、macOS Intel、Windows x64 已支持。
- 可用
CLAUDE_COMPUTER_USE_ENABLED=0禁用。 - 第一次使用先从简单、可观察的任务开始，不要直接交给复杂多应用流程。
如果你觉得会话状态不对，或想看当前上下文和用量，就看这一节。
- 输入
/status查看当前会话状态。 - 输入
/context查看上下文窗口占用、剩余 token、消息和工具结果占比。 - 输入
/cost查看可用的用量和成本信息。 - 输入
/doctor检查本地环境健康情况。 - 测试本地桌面服务时，可运行
curl http://127.0.0.1:3456/health。 - 供应商请求失败时，到 Settings -> Providers 里运行连接测试。
- 桌面端无法接入某个会话时，先确认项目目录仍然存在。
验证结果：你能判断问题大概来自供应商配置、上下文压力、本地服务状态，还是项目路径失效。
| 类别 | 技术 |
|---|---|
| 运行时 | Bun |
| 语言 | TypeScript |
| 终端 UI | React + Ink |
| CLI 解析 | Commander.js |
| API | Anthropic SDK |
| 协议 | MCP, LSP |
| 文档 | 说明 |
|---|---|
| 环境变量 | 完整环境变量参考和配置方式 |
| 第三方模型 | 接入 OpenAI / DeepSeek / Ollama 等非 Anthropic 模型 |
| 知识空间与代码图谱 | 自动图谱上下文、可视化与本地文件 / 文件夹知识来源 |
| 数据迁移与 U 盘便携模式 | 迁移 Agent 的 Skills / 记忆 / 规则，或制作可跨系统启动的便携工作盘 |
| 记忆系统 | 跨会话持久化记忆的使用与实现 |
| 多 Agent 系统 | 多代理编排、并行任务执行与 Teams 协作 |
| Skills 系统 | 可扩展能力插件、自定义工作流与条件激活 |
| Channel 系统 | 通过 Telegram/飞书/Discord 等 IM 平台远程控制 Agent |
| Computer Use | 桌面控制功能（截屏、鼠标、键盘）— 架构解析 |
| 桌面端 | Tauri 2 + React 图形化客户端 — 快速上手 | 架构设计 | 安装指南 |
| 全局使用 | 在任意目录启动 cybercode |
| 常见问题 | 常见错误排查 |
| 项目结构 | 代码目录结构说明 |
| Roadmap | 近期优先级和适合新手的贡献方向 |
| Contributing | 如何贡献文档、供应商配置、测试和桌面端修复 |
| Launch Kit | 可直接复制使用的传播文案 |
感谢以下开源项目和社区实践为本项目提供参考与启发：
如果这个项目对您有帮助，请给个 ⭐ Star 支持一下，让更多的人看到 CyberCode！
本项目高度借鉴 Anthropic 推出的 Claude Code 的产品设计、交互模式与功能架构进行独立实现。Claude / Claude Code 是 Anthropic 的商标，相关 API 与协议归 Anthropic 所有。本项目仅作技术学习与研究用途，与 Anthropic 无任何商业关联。