快速入门
先在本机完成一个任务,再逐步增加远程连接的复杂度。

安装之前
从包含目标项目和 Provider 的电脑开始,并从 Releases 选择经过验证的安装包。
- 当前操作系统用户需要能够使用受支持的 Codex 或 Claude Code。
- Provider 登录、订阅和 API 用量独立于 CodeTether。
- 项目文件夹必须已经存在,并且在执行机器上保持可用。
安装合适的组件
使用 Desktop 获得完整工作区和本地执行能力。只有另一台 Mac 或 Linux 机器需要接受远程任务时,才安装 Node。
检查编程 Agent
- 打开 Setup 或 Doctor,检查发现的 Provider 安装。
- 如果需要登录,请在 Provider 自己的支持流程中完成。
- 区分安装可用性和最近一次执行健康状态。
添加项目
- 在工作区选择添加项目。
- 在 Desktop 中选择已有文件夹,或在浏览器模式输入绝对路径。
- 检查 CodeTether 显示的规范项目位置和可用状态。
发送第一个任务
- 创建会话,并明确选择机器、项目和 Provider。
- 填写任务内容,确认上下文后启动。
- 在会话工作区查看 Agent 输出、工具、文件、差异和待处理事项。
网络响应丢失不代表可以自动重发 Provider 任务。如果执行归属不确定,请先检查会话,再决定是否开始新任务。