SuperAPI AI 工具集

claude-code

智能体与模型

查看项目

更新于 10-16 07:15

技能介绍

用途:Claude Code 是 Anthropic 的自主编码代理 CLI,可读取文件、编写代码、运行 shell 命令、派生 subagent 并管理 git 工作流。本文档说明如何通过终端编排它来委派编码任务(功能开发、PR 等)。

安装与认证:npm install -g @anthropic-ai/claude-code;首次运行 claude 登录(Pro/Max 走浏览器 OAuth,或设置 ANTHROPIC_API_KEY)。可用 claude auth login --console、--sso(Enterprise)、claude auth status、claude doctor、claude --version(需 v2.x+)、claude update 或 claude upgrade。

两种编排模式: 1)打印模式(-p,首选):一次性执行任务后退出,无需 PTY 和交互确认,适合单次编码、CI/CD、管道输入与结构化提取。示例:claude -p '任务' --allowedTools 'Read,Edit' --max-turns 10。 2)交互 PTY(tmux):多轮对话式 REPL,可发后续提示、用斜杠命令、实时观察。用 tmux new-session 启动,tmux send-keys 发送任务,tmux capture-pane 监控,/exit 结束。交互模式需处理两个确认对话框:工作区信任(默认回车即可)与权限绕过(需先 Down 再 Enter)。

主要 CLI 能力:claude -c 继续最近会话、-r 恢复指定会话、mcp add/list/remove 管理 MCP、agents、remote-control、plugin、setup-token 等。

打印模式输出:--output-format json 返回含 session_id、num_turns、total_cost_usd、usage 等字段;stream-json 配合 --verbose 与 --include-partial-messages 可实时流式输出;--json-schema 强制结构化 JSON;支持管道输入(cat file | claude -p '...')。会话可通过 --resume 或 --continue 延续,--fork-session 可分叉。--bare 适合 CI/脚本,跳过 hooks、plugins、MCP 与 CLAUDE.md(需 API key)。--fallback-model 用于模型过载时回退。

常用标志:--model、--effort、--max-turns、--max-budget-usd、--permission-mode、--allowedTools/--disallowedTools(支持 Bash(git *) 等语法)、--append-system-prompt、--agents、--mcp-config、--settings、--debug。

配置:设置优先级为 CLI 标志 > .claude/settings.local.json > .claude/settings.json > ~/.claude/settings.json;记忆文件为 ~/.claude/CLAUDE.md、./CLAUDE.md、.claude/CLAUDE.local.md。交互斜杠命令包括 /compact、/clear、/context、/cost、/resume、/rewind、/review、/security-review、/plan、/model 等。

限制:需 Node/npm 与有效认证;--dangerously-skip-permissions 会跳过全部权限确认,存在风险;打印模式不支持多轮;--bare 跳过插件与 MCP 发现;具体收费、价格与平台支持以官方资料为准,本文暂未提供。