Claude Code Doc

37 阅读4分钟

安装

第一步:安装 Claude Code

在终端中执行以下命令,全局安装 Claude Code:

npm install -g @anthropic-ai/claude-code

安装完成后,执行以下命令验证:

claude --version

第二步:配置环境变量

Claude Code 通过 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 确定服务地址与鉴权密钥。

Windows(以管理员身份打开 PowerShell):

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://中转.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 API Key", [System.EnvironmentVariableTarget]::User)

配置完成后,重启终端窗口使变量生效。

ANTHROPIC_AUTH_TOKEN 必须使用 Claude Code 专属分组的 API Key,不可使用其他客户端分组的密钥。

第三步:启动 Claude Code

claude       # 交互式会话
claude -p "问题"   # 非交互式,执行后退出

settings.local.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

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更改语法高亮主题
/focus精简视图,仅显示最后提示 + 响应摘要
/login重新身份验证
/logout登出
/upgrade升级套餐
/help列出所有可用命令

功能

命令说明
/agents创建和管理子智能体
/skills技能管理菜单
/powerup动画教学 context/hooks/MCP/subagents/loop
/review审查 Pull Request
/security-review对未提交变更进行安全审计
/mcp管理 MCP 服务器连接
/plugin进入插件市场,安装插件
/tasks查看后台任务
/loop定时运行命令(可省略间隔,自调度)
/batch跨 worktree 大规模并行重构
/insights生成使用分析报告
/usage检查令牌使用量与套餐限额
/doctor运行环境诊断
/debug显示故障排查信息
/team-onboarding生成新成员上手指南
/simplify3 智能体审阅(架构、重复代码、性能)
/memory编辑记忆文件
/ide管理 IDE 集成

配置

命令说明
/config打开设置面板(主题、模型偏好、语言等)
/permissions管理工具权限
/terminal-setup设置 Shift+Enter 快捷键
/hooks配置生命周期钩子
/init新项目开局运行,生成 CLAUDE.md

全局命令 vs 项目命令

Claude Code v2.1.3 起,自定义斜杠命令与 Agent Skills 合并。可以将命令文件(.md)放置在不同位置来控制作用范围:

位置作用范围是否纳入版本控制
.claude/commands/*.md当前项目
~/.claude/commands/*.md全局(所有项目)

全局命令示例 — 创建 ~/.claude/commands/review.md

分析文件 $ARGUMENTS,指出:

1. 潜在 bug
2. 性能问题
3. 改进建议

然后在任意项目中使用:/review src/auth.ts

优先级:项目级命令覆盖全局同名命令。

你也可以在 ~/.claude/CLAUDE.md 中写入个人指令,它会在每个会话中自动加载。

CLI

命令说明
claude启动交互式会话
claude "问题"启动时附带初始提示
claude -p "问题"非交互式模式,执行后退出
claude -c / -r "ID" / --from-pr恢复会话
claude update更新到最新版本
claude auth login/logout/status身份验证
claude agents列出已配置的智能体
claude rc启动远程控制会话
claude plugin插件管理
claude config list/set管理设置
claude mcp add/list/remove/serve管理 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 配置文件