账号管理¶

添加账号¶

coderfleet account add alice TYPE=codex
coderfleet account add bob TYPE=claude
coderfleet account add carol TYPE=opencode
coderfleet account add dave TYPE=hermes
coderfleet account add eve TYPE=grok --auth env
coderfleet account add frank TYPE=kimi

账号名只允许字母、数字和连字符。

查看账号¶

coderfleet account list

删除账号¶

coderfleet account remove alice

删除账号只会移除配置，认证目录仍会保留在工作区中。如需彻底清理，需要手动删除对应目录。

登录账号¶

coderfleet login alice

登录命令会根据账号类型执行对应的 CLI 认证流程：

类型	容器内命令	认证数据目录
`codex`	`codex login --device-auth`	`/home/byclaw/.codex`
`claude`	`claude login`	`/home/byclaw/.claude`
`opencode`	`opencode auth login`	`/home/byclaw/.opencode`
`hermes`	`hermes setup`	`/home/byclaw/.hermes`
`grok`	仅支持 `AUTH=env`，无需登录	`/home/byclaw/.grok`
`kimi`	`kimi login`	`/home/byclaw/.kimi-code`

登录所有需要网页登录的账号（AUTH=env 账号自动跳过）：

coderfleet login all

API Key 认证¶

Claude Code、OpenCode、Hermes Agent、Grok Build 和 Kimi Code 可以通过 env 文件注入 API key：

coderfleet account add claude-api TYPE=claude --auth env
coderfleet account add opencode-api TYPE=opencode --auth env
coderfleet account add hermes-api TYPE=hermes --auth env
coderfleet account add grok-api TYPE=grok --auth env
coderfleet account add kimi-api TYPE=kimi --auth env

然后编辑：

~/.coderfleet/accounts/<账号名>/env

各类型示例：

# Claude Code
ANTHROPIC_API_KEY=sk-ant-...

# Grok Build
XAI_API_KEY=xai-...

# Kimi Code
KIMI_MODEL_NAME=kimi-for-coding
KIMI_MODEL_API_KEY=sk-...
KIMI_MODEL_BASE_URL=https://api.moonshot.ai/v1

Hermes Agent 需要根据实际 provider 配置对应 API key，例如 ANTHROPIC_API_KEY 或 OPENAI_API_KEY。添加 TYPE=hermes --auth env 后，还需要在容器里完成 Hermes provider 初始化：

coderfleet enter <绑定该账号的项目名>
hermes config set model.provider anthropic

CoderFleet 会在 Hermes 容器启动时设置 HERMES_HOME=/home/byclaw/.hermes，并关闭交互式审批提示，便于后台任务执行。

Grok Build¶

Grok Build 只支持 AUTH=env 认证，不支持交互式登录：

coderfleet account add my-grok TYPE=grok --auth env
coderfleet project add my-project my-grok ~/projects/my-project
coderfleet apply

在 ~/.coderfleet/accounts/my-grok/env 中配置：

XAI_API_KEY=xai-...

API Key 在 console.x.ai 获取。CoderFleet 会在 Grok 容器启动时设置 GROK_HOME=/home/byclaw/.grok 和 GROK_NO_AUTO_UPDATE=1。

Kimi Code¶

Kimi Code 支持 login 和 env 两种认证方式：

coderfleet account add my-kimi TYPE=kimi
coderfleet login my-kimi

如果使用 AUTH=env，需要配置 KIMI_MODEL_*。新版 Kimi Code 不会直接从 shell 环境读取 KIMI_API_KEY：

coderfleet account add my-kimi-api TYPE=kimi --auth env

在 ~/.coderfleet/accounts/my-kimi-api/env 中配置：

KIMI_MODEL_NAME=kimi-for-coding
KIMI_MODEL_API_KEY=sk-...
KIMI_MODEL_BASE_URL=https://api.moonshot.ai/v1

代理模式¶

默认账号使用代理中继：

coderfleet account add alice TYPE=codex

如果某个账号或本地模型不需要代理：

coderfleet account add local TYPE=claude --proxy off

本地执行模式（`--runtime local`）¶

默认情况下每个账号跑在独立的 Docker 容器里（--runtime container）。如果宿主机上已经装好了 claude/codex 等 CLI，也可以让账号直接调用宿主机二进制，不经过 Docker：

# 先确认宿主机上装了哪些 CLI
coderfleet account detect

# 创建一个 local 账号
coderfleet account add alice TYPE=claude --runtime local

local 账号的凭证隔离靠账号自己的 accounts/<name>/.claude（或 .codex）目录 —— 跟 container 场景一样，每个账号互不干扰，只是不再靠容器边界，而是靠 CLAUDE_CONFIG_DIR/CODEX_HOME 各自指向不同路径。

限制（先读这个再决定要不要用）：

--proxy relay 目前只支持 TYPE=claude。 Codex 自己的官方文档没有确认它的所有 HTTP client 都会尊重 HTTPS_PROXY（上游有个还没关闭的 issue，openai/codex#4242），本地执行没有 Docker 网络层兜底，无法像容器场景一样保证流量真的经过 relay。coderfleet account add ... TYPE=codex --runtime local --proxy relay 会被直接拒绝；需要代理就用 --proxy off，或者继续用 --runtime container。
auto 任务需要先确认沙箱。 auto 模式默认会用假设"外部已经隔离好"的旗标（Claude 的 --dangerously-skip-permissions、Codex 的 --dangerously-bypass-approvals-and-sandbox）——这两个旗标官方文档都写着只推荐在已经被容器/VM 隔离的环境里用。local 账号没有容器兜底，必须先手工开启该 CLI 自带的 OS 级沙箱，再加 --sandbox-confirmed 确认：

coderfleet account add alice TYPE=claude --runtime local --sandbox-confirmed

没加这个标志的 local 账号能正常跑非 auto 任务，但提交 auto 任务会被明确拒绝（不会静默降级成无沙箱执行）。 - 不支持会话复用（keep-container）。 container 场景下可以让一个容器常驻、反复 exec 进去；local 场景每次任务都是一次全新的宿主机子进程调用，靠 CLI 自己的 --resume 衔接上下文。 - 不支持持久容器（Interactive 模式），coderfleet enter/coderfleet up 仍然是 container 账号的能力，local 账号只能通过 Task/Conversation 提交任务。

完整的调研依据（官方文档引用、--help 原文）见 docs/research/local-execution-mode.md。