Coder工作空间

通过coder CLI管理Coder工作空间和AI编码代理任务。

注意：命令在隔离的、受管控的Coder工作空间内执行——而非主机系统。

设置

在使用coder CLI之前，请配置身份验证：

1. 从以下位置安装CLICoder CLI文档

2. 设置环境变量：

   export CODER_URL=https://your-coder-instance.com
   export CODER_SESSION_TOKEN=<your-token>  # Get from /cli-auth
   

3. 测试连接：

   coder whoami
   

工作空间命令

coder list                              # List workspaces
coder list --all                        # Include stopped
coder list -o json                      # JSON output

coder start <workspace>
coder stop <workspace>
coder restart <workspace> -y
coder delete <workspace> -y

coder ssh <workspace>                   # Interactive shell
coder ssh <workspace> -- <command>      # Run command in workspace

coder logs <workspace>
coder logs <workspace> -f               # Follow logs

AI编码任务

Coder任务在隔离的工作空间中运行AI代理（Claude Code、Aider等）。

创建任务

coder tasks create --template <template> --preset "<preset>" "prompt"

• 模板：必需。使用coder templates list
• 列出模板预设：可能必需。首先尝试不指定。如果创建失败并提示“必需参数未提供”，请使用coder templates presets list <模板> -o json

管理任务

coder tasks list                        # List all tasks
coder tasks logs <task-name>            # View output
coder tasks connect <task-name>         # Interactive session
coder tasks delete <task-name> -y       # Delete task

任务状态

• 初始化中：工作区资源调配（时间因模板而异）
• 工作中：设置脚本正在运行
• 活跃状态：代理正在处理提示
• 空闲状态：代理正在等待输入

故障排除

• 未找到CLI：请参阅Coder CLI 文档
• 认证失败：请确认 CODER_URL 和 CODER_SESSION_TOKEN 已设置，然后运行coder login
• 版本不匹配：请从您的 Coder 实例重新安装 CLI

更多信息

• Coder 文档
• Coder CLI
• Coder 任务