ClawCodex

这个 Agent 能做什么，适合哪些场景？

ClawCodex 是一个以 Python 实现的 Claude Code 风格编程代理，提供可交互的终端界面和可脚本化的命令行入口。默认交互界面是 TypeScript Ink TUI，它通过 NDJSON 管道启动并控制 Python agent-server；无界面任务可通过 clawcodex -p 执行。代理循环可流式输出、调用文件与 Shell 工具、保存会话，并通过 SKILL.md 扩展斜杠命令。它支持 Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter 等提供方及 OpenAI 兼容服务，也支持 Ollama、vLLM、SGLang 等本地服务器。项目还提供权限模式、MCP 工具与资源接线、计划模式、定时任务和 /eco Bash 输出压缩；采用前应评估其默认交互式 Full Access 权限及外部模型服务依赖。

用户启动 clawcodex 后，Ink TUI 将提示词、@ 文件引用和斜杠命令发送给 Python agent-server；也可用 clawcodex -p "..." 直接运行一次任务。agent loop 根据已配置的 provider/model 流式接收模型响应，并调用 Read、Write、Edit、Glob、Grep、Bash、WebFetch、WebSearch、AskUserQuestion、TodoWrite、Agent 等工具，随后把工具结果继续送回模型直至完成。配置保存在 ~/.clawcodex/config.json，可通过 clawcodex login 写入 API 凭据、默认模型和可选的 TAVILY_API_KEY；会话及权限设置另可持久化。/eco 会对进入模型上下文的 Bash 输出执行确定性压缩，并保留可恢复的完整输出；clawcodex mcp serve 可将 ClawCodex 工具以 MCP stdio server 形式暴露。

1. 需要在本地 Git 项目中让终端代理阅读源码、修改文件、运行测试和执行 Shell 命令的 Python 或全栈开发者。
2. 需要在 CI、脚本或其他自动化流程中通过 clawcodex -p、JSON 或 NDJSON 输入输出执行一次性代码任务的工程团队。
3. 希望在同一套工具调用与技能工作流中切换 Anthropic、OpenAI、DeepSeek、Gemini 或本地 Ollama/vLLM/SGLang 模型的团队。
4. 在长时间排障或测试失败场景中，需要用 /eco 缩减 Bash 日志进入模型上下文的 token 用量，同时保留原始日志的开发者。
5. 需要通过 .clawcodex/skills/<skill-name>/SKILL.md 为仓库定义受限工具的自定义斜杠命令的项目维护者。
6. 需要让代理在会话空闲时按 cron 或 /loop 节奏检查构建、部署或待办事项的终端用户。

如何安装或部署这个 Agent？

需具备 Python 3.10+、网络连接，以及至少一个提供方的 API key 或支持的订阅登录。推荐安装：

pipx install clawcodex-cli

随后运行：

clawcodex login

按交互提示选择 provider 并配置凭据，最后验证：

clawcodex --help

也可从源码安装：

git clone https://github.com/agentforce314/clawcodex.git && cd clawcodex
uv venv --python 3.11 && source .venv/bin/activate
uv pip install -e ".[dev]"

交互式 Ink TUI 还需要 Node.js 18+ 和已构建的 ui-tui/dist；无界面 -p 路径不需要 Node。

如何使用这个 Agent？

完成登录后，在目标项目目录运行 clawcodex 启动交互式 TUI，或运行 clawcodex tui 显式启动。可用 @src/cli.py 引用文件，使用 /tools 查看工具，或运行项目技能命令。一次性任务示例：clawcodex -p "Summarize src/cli.py"；指定模型示例：clawcodex --provider anthropic --model claude-sonnet-4-6 -p "Find TODOs"。若需 WebSearch，在配置的 env 中加入 TAVILY_API_KEY。交互式会话默认是 Full Access；在执行前可用 /permissions 降低权限，或在无界面运行中使用 --permission-mode plan。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v1.7.0 v1.7.0 — the multi-agent system, rebuilt 2026-09-23
   发布说明摘录

   The multi-agent system, rebuilt ClawCodex used to spawn subagents down two paths that never met, and only one was observable: a foreground delegation registered nowhere, so nothing could list or stop it; the TUI's agents overlay called three RPCs with no backend, a follow-up to a finished background worker showed running without ever starting a model loop, and the team tools had no production path that ran a teammate. v1.7.0 rebuilds that layer. …

   在 GitHub 查看 ↗
2. v1.6.0 v1.6.0 — ClawCodex Web 2026-08-15
   发布说明摘录

   ClawCodex Web — the whole agent in a browser tab clawcodex web serves the full agent at a stable, typeable address — http://127.0.0.1:8081 — driving the same in-process agent, gateway, and durable sessions as the TUI and Desktop app. Streaming chat with collapsible reasoning, live tool cards (ANSI terminal transcripts, unified diffs, file reads), permission approvals with once/session/always grants, a mid-turn prompt queue, slash completion, a context meter, a live To-dos panel, and light/dark/system themes. …

   在 GitHub 查看 ↗
3. v1.5.0 v1.5.0 — ClawCodex Desktop 2026-08-08
   发布说明摘录

   ClawCodex Desktop — the whole agent in a native app v1.5.0 ships ClawCodex Desktop (ui-desktop/): streaming chat with a live tool trail and reasoning, permission approvals with once/session/always grants, a session sidebar that lists and resumes the same durable sessions as the TUI, side-by-side previews, settings — and the official pixel-art crab on the dock. ```bash clawcodex desktop # from a checkout — first run installs the UI deps ``` …

   在 GitHub 查看 ↗

常见问题