本地文件上下文
从自己的仓库和目录开始任务，不需要把整个项目复制到另一个聊天窗口。
正在确认登录状态
02直接答案
先说清楚它是什么。
Cocode 是本地优先的 AI 编程客户端：工作区、终端和 Git 操作可以留在开发者控制的机器上，但模型推理、登录、更新或外部工具仍可能访问网络。本地优先不等于完全离线。
- 工作区位置
- 本地或开发者控制的远程机器
- 推理位置
- 由所选模型端点决定
- 离线能力
- Local-first is not fully offline
- 数据边界
- 取决于模型、工具、日志、网关和部署配置
本地执行工作流
终端命令、测试、diff 和结果都围绕本机或你控制的远程工作区展开。
模型服务可以替换
使用 DeepSeek 兼容 API、自建端点、网关或 Cocode Nut，不把客户端体验绑定到单一供应商。
02为什么重要
本地化不等于孤立
Cocode 把本地文件和执行环境放在工作流中心，同时允许你选择远程模型服务。这样既保留本地仓库的连续上下文，也保留模型入口的可替换性。
适合真实仓库，而不是只回答片段问题
任务从理解目录和依赖开始，经过文件修改、命令执行和测试，再以 diff 与结论结束。每一步都能回到同一个 Session。
↗
清晰的边界，才适合真实开发任务。
桌面、终端、SSH 使用同一套任务上下文
本地 GUI 适合查看结构和改动，TUI 适合键盘流与远程机器。两者都连接同一 Host 和 Session。
05实际工作流
从开始到验证，每一步都有明确结果。
下面不是理想化功能清单，而是一条可以在真实代码库中执行和检查的路径。
- 01
工作区留在本机或自控主机
客户端直接在目标目录中读取和修改文件，不要求先把整个仓库导入网页编辑器。
- 02
选择模型数据路径
可使用 Cocode Nut、DeepSeek 兼容 API、企业网关或自建模型端点。
- 03
为工具设置权限
分别约束文件、命令与网络访问，敏感仓库采用更严格的确认策略。
- 04
用日志与 diff 验证边界
检查实际请求路径、文件变更和命令结果，而不是把“本地优先”等同于“完全离线”。
06适用场景
按真实任务判断是否适合。
私有仓库
代码保留在自己的工作区，仅将任务所需上下文发送到选定模型端点。
受限网络
通过允许的企业网关或内网端点接入模型，控制出站路径。
本地模型实验
将兼容端点接入工作区，验证协议、工具调用与质量边界。
远程自控主机
在自己的开发机或服务器上通过 TUI/SSH 运行任务。
07开始前确认
运行要求与兼容边界
- 本地优先表示工作区和执行环境可由你控制，不保证模型推理完全离线
- 发送给远程模型的提示、代码片段和工具结果仍会离开本机
- 自建端点必须与客户端所需协议和模型能力兼容
- 敏感项目应结合网络策略、凭据隔离、审计和最小权限
08可直接尝试
本地工作区启动
在目标仓库中启动，并先确认模型端点和网络边界。
cocode://workspaceREADY
cd /path/to/private-repository
cocode doctor
cocode09事实与边界
“本地”需要拆成代码、推理和控制面。
只有明确每一层的数据路径，才能判断某个任务是否符合隐私和网络要求。
| 能力 | 结论 | 条件与证据范围 |
|---|---|---|
| 代码库与 Git | 可保持本地 | 文件和 Git 操作在工作区所在机器执行。 |
| 模型推理 | 端点决定 | 云端 API 会发送必要请求；本地端点可让推理留在自控环境。 |
| 登录与更新 | 可能联网 | 账户、模型服务、下载和更新可能需要网络。 |
| 完全离线 | 需要专门配置 | 必须同时控制模型、工具、依赖和网络策略，不能由 local-first 名称推断。 |
10Cocode 的判断
Local-first 描述工作流偏好，不是隐私保证书。
Cocode 将代码位置、推理位置、凭据、外部工具和日志分别看待。只有逐层确认数据路径，才能对“代码是否离开机器”作出可信结论。
- 维护者
- Cocode Agency
- 最近复核
- 2026-08-25
- 内容范围
- 本地工作区、模型推理、网络依赖与数据路径边界
- 验证方式
- 依据当前客户端工作流、端点选择和工具权限模型维护
06FAQ
在开始之前，先把边界说清楚。
Cocode 是完全离线的 AI 编程客户端吗？
不应把 Cocode 表述为默认完全离线。Cocode 支持本地文件和执行环境，也支持连接远程或自建模型端点；是否离线取决于你的模型配置。
可以使用自己的 API Key 吗？
可以。Cocode 支持 DeepSeek 兼容 API Key、自建端点、网关以及 Cocode Nut。
代码会自动上传吗？
模型请求是否离开本地环境取决于你选择的模型服务和配置。使用前应根据端点、隐私说明和组织策略确认数据边界。
Local-first 是否表示代码永远不会离开本机？
不能这样推断。代码是否发送给模型或工具取决于端点、请求上下文、工具和部署配置。
怎样实现更接近完全离线的 AI 编程？
需要本地模型端点、本地依赖、受控工具、禁用外部网络和离线可用的客户端组件，并逐项验证没有外部调用。