Claude Code CLI 文档 — 命令、标志、无头模式（2026）

启动

claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session

值得了解的标志

-p, --print — 非交互式；通过管道传入输入并获取输出。这是所有脚本和 CI 用法的基础。
--output-format text|json|stream-json — 为打印模式提供结构化输出。
--model <id> — 端点提供的任意模型（/v1/models 可列出此网关上的模型）。
--allowedTools "Read,Edit,Bash(git *)" — 预先批准工具，让打印模式不会因等待确认而阻塞。
--dangerously-skip-permissions — 完全不询问确认。仅应在可随时丢弃的容器或沙盒中使用。
--max-turns N — 限制无头运行中的智能体循环次数。
--add-dir <path> — 让会话跨多个目录开展工作。

会话中的斜杠命令

/init — 为项目编写 CLAUDE.md（约定、构建命令、需要避免的事项）。
/compact [focus] — 总结对话以释放上下文；这是最有效的成本控制手段。
/clear — 清空上下文，重新开始。
/model — 在会话中切换模型； /cost — 查看截至目前的 token 用量与费用； /status — 查看端点、密钥、模型和版本。
/permissions — 查看智能体无需询问即可执行的操作； /config — 设置； /memory — 编辑记忆文件。
/mcp — 查看已连接的 MCP 服务器； /agents — 定义和管理子智能体； /hooks — 在工具事件上运行的 shell 钩子。
/review — 审查拉取请求； /doctor — 诊断安装问题； /help — 其他所有功能。

claude setup-token：为 CI 提供基于订阅的长期有效身份验证

claude setup-token 在浏览器中登录一次，然后输出用于 Claude Pro/Max 订阅的长期有效 OAuth 令牌，适用于无法使用 /login 的无头环境。在 CI 中将其导出为 CLAUDE_CODE_OAUTH_TOKEN，打印模式运行时就会使用订阅额度。它仅适用于订阅；如果使用 API 密钥（Anthropic 或网关），则无需此步骤，改为设置 ANTHROPIC_API_KEY 即可。

用于脚本和 CI 的打印模式

cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json

GitHub Action、编辑器集成和 Agent SDK 通过打印模式使用 Claude Code。将 ANTHROPIC_BASE_URL 设置为网关后，这些运行会从你的网关余额或无限套餐计费，而不是从 Anthropic 账户计费。

配置存放位置

CLAUDE.md 位于仓库根目录（以及 CLAUDE.local.md ，用于个人笔记）— 项目记忆，每次会话都会读取。
.claude/settings.json — 项目级权限、钩子、环境变量； ~/.claude/settings.json — 全局配置。
~/.claude/skills/ 和 .claude/skills/ — 技能； .claude/agents/ — 子智能体定义。
环境变量：ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN，以及模型指南中介绍的各档位模型覆盖配置。

先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚，之后可获得面值 7.69231 倍的额度。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

使用优惠码 CLAUDECODE 创建账户

常见问题

如何在不使用交互式提示界面的情况下运行 Claude Code？

使用打印模式：claude -p "你的提示"。在脚本中搭配 --allowedTools 和 --output-format json，并通过标准输入管道传入文件。

/compact 有什么作用？

它会要求模型总结截至目前的对话，并用该摘要替换历史记录。这样可缩减上下文、降低每轮成本，并让会话继续进行。每当任务方向发生变化时，都可以运行它。

可以为 Claude Code 使用不同的 API 基础 URL 吗？

可以，设置 ANTHROPIC_BASE_URL 即可。/status 可以确认会话正在使用哪个端点。

通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。新账户：使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。

获取 API 密钥查看不限量方案

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。

Claude Code CLI 文档：命令与参数

TLDR

启动