SuperAPI AI 工具集

claude-code

智能体与模型

查看项目

更新于 11-07 17:53

技能介绍

用途

该技能用于在另一个智能体(Codex 或任何能执行 shell 的智能体)中运行 Claude Code。Claude Code 是独立的智能体,拥有自己的工具、权限、项目记忆(CLAUDE.md)和会话存储。无头模式(-p)执行一轮任务后即退出;调用方与它通过文件交互:stdin 传入任务说明,stdout 得到 JSON 结果,并保留 session_id 用于后续追问。文档建议依赖某个参数前先用 claude --help 检查已安装版本。

主要能力

  • 启动任务:在仓库根目录 cd 后执行 claude -p,可用 --model(别名 fable、opus、sonnet、haiku 选各自最新,或完整 id 如 claude-opus-5-5 固定版本)、--effort(low、medium、high、xhigh、max,设计与评审建议 high)、--permission-mode(plan、acceptEdits、auto、dontAsk、bypassPermissions;无头运行无法应答提示,需提前选好不会触发询问的模式)、--allowedTools / --disallowedTools(如禁止 Bash(git commit *)、Bash(git push *))、--output-format json。JSON 对象包含 result、session_id、is_error、subtype、stop_reason、permission_denials、safety_stops、total_cost_usd、num_turns 等字段。
  • 可选参数:--max-budget-usd 限制花费,--json-schema 约束最终答案,--session-id <uuid> 预先设定会话 id(便于后台启动前记录),--append-system-prompt 追加常驻规则,--no-session-persistence 用于一次性运行。
  • 后台运行:长任务放后台并等待进程退出,不要循环轮询;--bg 可启动受管后台会话(配套 claude agents、claude logs <id>、claude stop <id>)。
  • 续接会话:在同一目录用 claude -p --resume "$id" 继续,需再次传入 model、effort 与权限模式;--fork-session 配合 --resume 会分支复制而非延长原会话。建议让完成工作的 worker 处理追问,独立评审则新开会话。
  • 检查结果:确认 is_error 为 false、subtype 为 success,否则读日志;permission_denials 非空表示它需要当前模式未允许的权限,需决定放宽模式或缩小任务;safety_stops 非空或结果说明模型安全机制拦截了消息,表示该轮被中止而非已回答,不要原样重发,应围绕实际目标改写、拆出触发部分或自行完成。结果报告描述的是意图,应自行查看其工作树的 git status / git diff 并运行检查。
  • 运行其他模型:Claude Code 也可通过 Anthropic 兼容端点托管非 Claude 模型,如 GLM-5 与 Qwen 3。仅在单次运行的环境中设置端点和三层模型映射,以免影响自己的会话:需显式映射 opus / sonnet / haiku 三档(内部子代理与摘要会用到);--effort 会透传给厂商并按其文档映射;Claude 特有功能(safeguard 字段、部分 beta 工具)可能缺失或行为不同,应检查 is_error 与 diff 而非只看 result;密钥属于用户,使用前须征得同意。资料给出的端点包括 GLM-5(Z.ai)https://api.z.ai/api/anthropic (中国区 https://open.bigmodel.cn/api/anthropic),模型 glm-5.3[1m] / glm-5.3[1m] / glm-5.3-flash[1m];Qwen 3(阿里)Token Plan https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic 与 Coding Plan https://coding-intl.dashscope.aliyuncs.com/apps/anthropic,模型 qwen3.8-max / qwen3.8-flash / qwen3.6-flash。Qwen 地址以 /apps/anthropic 结尾且无 /v1,不同套餐的密钥会返回 401;两个端点都不列出模型,需显式指定。

使用方式与隔离

与其他会改文件的智能体遵循相同规则:每个 worker 一个范围,绝不让两个 worker 操作同一批文件,worker 不做提交。若自己的检出有未提交改动,可为 Claude 创建独立的 detached worktree 并用该工作播种,cd 进该 worktree 运行(codex 技能提供 scripts/isolate.sh)。

限制与常见失败

  • 挂起或因拒绝而提前停止:权限模式需要无人能应答的提示,应提前选好模式。
  • 续接提示无此会话:工作目录与最初运行不同(会话按项目路径存储)。
  • 忽略项目约定:未在仓库根启动,CLAUDE.md 未加载。
  • 结果为空且 safety_stops 已设置:安全机制中止,改写或改道该部分,不要原样重试。
  • 花费或轮次失控:加 --max-budget-usd 并在任务说明中收窄范围。