Source: https://aiprimetech.io/zh/claude-code/cli/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › CLI 参考

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：2026 年 11 月

# Claude Code CLI 文档：命令与参数

Claude Code 提供两种使用方式：通过以下命令启动的交互式会话 claude，以及用于脚本和 CI 的非交互式打印模式。本文是这两种方式的实用参考。

## TLDR
- claude 在当前目录启动交互式会话； claude -p "..." 执行一个提示后退出。
- 斜杠命令用于管理会话：/init、/compact、/clear、/model、/cost、/status、/permissions、/mcp、/agents。
- --output-format json 和 --allowedTools 支持通过脚本调用； -c / -r 恢复会话。

## 启动 

```
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 创建账户](/register?promo=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 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

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

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code SDK，现已更名为 Claude Agent SDK](/zh/claude-code/sdk/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 子智能体：工作原理、定义方法与智能体团队](/zh/claude-code/subagents/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例](/zh/claude-code/mcp/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误](/zh/claude-code/vscode/)[如何在 Claude Code 中使用 OpenRouter（以及何时不宜使用）](/zh/claude-code/openrouter/)[Claude 速率限制错误：“API error: rate limit reached”的含义与解决方法](/zh/claude-code/rate-limits/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)