一个工作区
会话、文件、终端、Git 和运行状态在同一个上下文里。
正在确认登录状态
01AI CODING AGENT / WORKSPACE 01
真正能推进代码任务的 AI coding agent
从理解代码库开始，到修改文件、运行命令、查看 diff 和确认结果，Cocode 把一次开发任务放进一条可检查的工作流。
能力与限制以当前版本为准
02直接答案
先说清楚它是什么。
Cocode 是面向真实代码库的 AI coding agent：它把模型、文件、终端、工具、Session、diff 与测试放进同一条可检查的开发工作流。它适合需要完成跨文件任务并验证结果的开发者，不是只处理粘贴代码片段的聊天框。
- 产品类型
- 桌面 GUI 与终端 TUI AI 编程客户端
- 主要任务
- 理解仓库、修改代码、运行命令、审查 diff、验证结果
- 模型入口
- Cocode Nut、DeepSeek 兼容 API、自建端点或网关
- 安全边界
- 权限、确认、Git diff 与真实测试共同约束影响
每一步可确认
写文件、执行命令和联网动作都可以在继续前先看清影响。
两种入口，同一会话
桌面 GUI 和终端 TUI 连接同一个 Host 与 Session。
02为什么重要
不是只会补全代码的聊天框
Cocode 面向完整任务：先理解仓库，再提出计划，执行工具调用，展示改动，最后运行测试并交付结果。
模型和运行方式由你决定
可以使用 Cocode Nut、DeepSeek 兼容 API Key、自建端点或网关。Cocode 本身不捆绑单一模型供应商。
↗
清晰的边界，才适合真实开发任务。
从桌面到 SSH，任务不会断
在 GUI 中开始任务，之后通过 TUI 或 SSH 继续推进；客户端展示态不写进会话日志，Session 可以被不同入口重建。
05实际工作流
从开始到验证，每一步都有明确结果。
下面不是理想化功能清单，而是一条可以在真实代码库中执行和检查的路径。
- 01
连接真实代码库
选择工作区，让 agent 先读取目录、依赖、项目约定和当前 Git 状态。
- 02
理解目标与约束
把验收标准、禁止改动范围和运行环境说清楚，再由 agent 补齐必要上下文。
- 03
规划并执行工具
将任务拆成可检查步骤，按权限边界读取文件、修改代码、运行命令或访问网络。
- 04
检查 diff 与测试
对照目标查看实际文件差异、命令输出和测试结果，而不是只接受文字总结。
- 05
交付或继续修复
结果通过后交付；如果验证失败，保留 Session 上下文继续定位并修复。
06适用场景
按真实任务判断是否适合。
修复跨文件缺陷
追踪调用链、修改实现、补回归测试，再用真实命令验证。
新增 API 与集成
同步处理路由、数据结构、客户端调用、文档和测试。
重构与迁移
先确认行为边界，再分阶段修改并持续运行类型检查和测试。
远程环境排障
通过 TUI 与 SSH 在服务器、容器或无图形环境中继续同一任务。
07开始前确认
运行要求与兼容边界
- 一个可访问的本地或远程工作区
- Cocode GUI 或支持 TTY 的 Cocode TUI
- Cocode Nut、DeepSeek 兼容 API 或自建模型端点
- 可选：Git，用于审查差异和保留可回滚历史
08可直接尝试
最短启动路径
先检查 Host、配置和终端环境，再进入当前工作区。
cocode://workspaceREADY
cocode doctor
cocode09事实与边界
AI coding agent 能做什么，取决于哪一层。
客户端能力、模型能力和工作区权限必须同时成立；下面只陈述 Cocode 工作流可以验证的边界。
| 能力 | 结论 | 条件与证据范围 |
|---|---|---|
| 读取代码库 | 支持 | 限于当前用户和沙箱可以访问的工作区。 |
| 修改与运行命令 | 按权限执行 | 写文件和命令可能需要确认，并受操作系统权限约束。 |
| GUI / TUI 续接 | 同范围支持 | 需要连接同一 Host、Profile 与 Session 数据。 |
| 完全离线运行 | 不作默认承诺 | 模型推理、登录、更新或外部工具可能需要网络。 |
10Cocode 的判断
可靠的 agent 不是“会回答”，而是“能证明结果”。
Cocode 判断任务是否完成时，优先看真实文件差异、命令退出状态和测试结果。模型总结只是解释层，不能替代仓库和运行环境中的证据。
- 维护者
- Cocode Agency
- 最近复核
- 2026-08-25
- 内容范围
- Cocode GUI、TUI、Host、Session 与模型入口的公开工作流
- 验证方式
- 依据当前页面实现、产品行为边界与仓库级检查维护
06FAQ
在开始之前，先把边界说清楚。
Cocode 是什么？
Cocode 是基于 DeepSeek Harness developer preview 的独立发行版，提供桌面 GUI、终端 TUI 和模型服务入口。
Cocode 会自动修改我的文件吗？
工具动作遵循权限和确认流程。你可以在写入文件、执行命令或联网前查看影响。
必须使用 Cocode Nut 吗？
不必须。你可以使用自己的 DeepSeek 兼容 API Key、自建模型端点或 Cocode Nut。
AI coding agent 和普通代码聊天工具有什么区别？
关键区别是是否能在真实工作区中读取上下文、执行工具、展示文件差异并运行验证。仅生成代码文本不等于完成仓库任务。
怎样判断一次 agent 任务真的完成？
至少核对实际 diff、相关测试或构建、命令退出状态和剩余风险；不要只依据模型给出的完成声明。