安装
第一步:安装 Claude Code
在终端中执行以下命令,全局安装 Claude Code:
bash
npm install -g @anthropic-ai/claude-code
安装完成后,执行以下命令验证:
bash
claude --version
第二步:配置环境变量
Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 确定服务地址与鉴权密钥。
Windows(以管理员身份打开 PowerShell):
powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://xxx.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 API Key", [System.EnvironmentVariableTarget]::User)
配置完成后,重启终端窗口使变量生效。
ANTHROPIC_AUTH_TOKEN必须使用 Claude Code 专属分组的 API Key,不可使用其他客户端分组的密钥。
第三步:启动 Claude Code
bash
claude # 交互式会话
claude -p "问题" # 非交互式,执行后退出
settings.local.json 常规设置
json
{
"permissions": {
"allow": [
"Bash(claude --version)",
"Bash(claude --print)",
"WebSearch",
"Bash(claude settings *)",
"Read(//c/Users/Administrator/.claude/**)",
"WebFetch(domain:dev.to)",
"Bash(npx tsc *)"
]
}
}
安装位置(快捷键进入):%USERPROFILE%\.claude
Chrome DevTools MCP
bash
claude mcp add chrome-devtools -s user -- npx chrome-devtools-mcp@latest
安装后可通过 MCP 工具操控浏览器、截图、性能追踪等。
命令
会话管理
| 命令 | 说明 |
|---|---|
/clear |
清空对话历史 |
/compact |
压缩对话历史但保留摘要 |
/resume |
恢复之前的对话 |
/fork |
将对话分支为新会话 |
/rename |
重命名当前会话 |
/btw |
快速插问,不打断正在执行的任务 |
/rewind |
回退对话节点,代码文件一起恢复 |
/context |
查看上下文窗口占用情况 |
/export |
导出对话为纯文本文件 |
/diff |
在交互式查看器中查看所有变更 |
/branch |
分支管理 |
模型与输出
| 命令 | 说明 |
|---|---|
/model |
在 Opus、Sonnet 和 Haiku 间切换 |
/fast |
切换快速模式 |
/effort |
交互式推理强度滑块(low / medium / high / xhigh / max) |
/plan |
切换计划模式(只读规划) |
/theme |
更改语法高亮主题 |
/output-style |
更改输出样式 |
/voice |
语音输入(针对编程词汇优化) |
/focus |
精简视图,仅显示最后提示 + 响应摘要 |
配置与设置
| 命令 | 说明 |
|---|---|
/config |
打开设置面板(主题、模型偏好、语言等) |
/permissions |
管理工具权限 |
/keybindings |
打开快捷键配置 |
/status-line |
设置终端状态栏 |
/terminal-setup |
设置 Shift+Enter 快捷键 |
/hooks |
配置生命周期钩子 |
/init |
新项目开局运行,生成 CLAUDE.md |
子智能体与技能(v2.1.3 起斜杠命令与 Skills 统一)
| 命令 | 说明 |
|---|---|
/agents |
创建和管理子智能体 |
/skills |
技能管理菜单 |
/find-skills |
浏览并安装技能 |
/powerup |
动画教学,学习 context/hooks/MCP/subagents/loop |
代码审查与安全
| 命令 | 说明 |
|---|---|
/review |
审查 Pull Request |
/pr-comments |
显示当前分支的 PR 评论 |
/autofix-pr |
CI 失败或 Reviewer 评论时自动推送修复 |
/install-github-app |
设置 GitHub PR 自动审阅 |
/security-review |
对未提交变更进行安全审计 |
MCP 与插件
| 命令 | 说明 |
|---|---|
/mcp |
管理 MCP 服务器连接 |
/plugin |
进入插件市场,安装插件 |
后台与自动化
| 命令 | 说明 |
|---|---|
/tasks |
查看后台任务 |
/loop |
定时运行命令(可省略间隔,自调度) |
/batch |
跨 worktree 大规模并行重构 |
诊断与统计
| 命令 | 说明 |
|---|---|
/insights |
生成使用分析报告 |
/usage |
检查令牌使用量与套餐限额 |
/doctor |
运行环境诊断 |
/debug |
显示故障排查信息 |
其他
| 命令 | 说明 |
|---|---|
/team-onboarding |
生成新成员上手指南(基于你的使用习惯) |
/simplify |
3 智能体审阅(架构、重复代码、性能) |
/memory |
编辑记忆文件 |
/sandbox |
启用沙箱模式 |
/ide |
管理 IDE 集成 |
账户
| 命令 | 说明 |
|---|---|
/login |
重新身份验证 |
/logout |
登出 |
/upgrade |
升级套餐 |
/help |
列出所有可用命令 |
全局命令 vs 项目命令
Claude Code v2.1.3 起,自定义斜杠命令与 Agent Skills 合并。可以将命令文件(.md)放置在不同位置来控制作用范围:
| 位置 | 作用范围 | 是否纳入版本控制 |
|---|---|---|
.claude/commands/*.md |
当前项目 | ✓ |
~/.claude/commands/*.md |
全局(所有项目) | ✗ |
全局命令示例 --- 创建 ~/.claude/commands/review.md:
markdown
分析文件 $ARGUMENTS,指出:
1. 潜在 bug
2. 性能问题
3. 改进建议
然后在任意项目中使用:/review src/auth.ts
优先级:项目级命令覆盖全局同名命令。
你也可以在
~/.claude/CLAUDE.md中写入个人指令,它会在每个会话中自动加载。
CLI 命令
| 命令 | 说明 |
|---|---|
claude |
启动交互式会话 |
claude "问题" |
启动时附带初始提示 |
claude -p "问题" |
非交互式模式,执行后退出 |
claude -c |
恢复最近会话 |
claude -r "ID" |
按 ID 恢复会话 |
claude --from-pr |
恢复与 PR 关联的会话 |
claude update |
更新到最新版本 |
claude auth login |
身份验证 |
claude auth status |
检查认证状态 |
claude auth logout |
登出 |
claude agents |
列出已配置的智能体 |
claude rc |
启动远程控制会话 |
claude plugin |
插件管理(CLI 方式) |
claude config list |
显示所有设置 |
claude config set |
更新设置项 |
claude mcp add |
添加 MCP 服务器 |
claude mcp list |
列出 MCP 服务器 |
claude mcp remove |
移除 MCP 服务器 |
claude mcp serve |
将 Claude Code 作为 MCP 服务器运行 |
claude ultrareview [PR/分支] |
云端多智能体代码审查 |
CLI 启动参数
| 参数 | 说明 |
|---|---|
--model opus |
启动时指定模型 |
--effort high |
设置推理深度(low/medium/high/xhigh/max) |
--agents '{json}' |
启动时定义子智能体 |
--append-system |
追加系统提示词 |
--max-turns N |
设置会话轮次上限 |
--dangerously-skip |
跳过权限提示(危险) |
--worktree |
隔离 Git 工作树 |
--bare |
最小模式:跳过 hooks/LSP/自动记忆等 |
--output-format json |
输出格式(text/json/stream-json) |
--settings <file> |
加载额外设置文件 |
--mcp-config <file> |
加载 MCP 配置文件 |