Skip to main content

Claude Code

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

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 claude

npx -y ccusage blocks --live
npx -y ccusage session

claude config list
cmdfor
!进入 bash 模式运行终端命令
/执行 Claude Code 内置命令
@快速引用或操作文件路径
#记忆内容供后续使用
esc esc清空当前输入
ctrl + _撤销操作
shift + tab自动接受编辑建议
ctrl + r启用详细输出模式
ctrl + z暂停 Claude Code
shift + ⏎换行（在输入框中）
  • ~/.claude.json

配置文件和优先级

  • ~/.claude/settings.json
  • .claude/settings.json
  • .claude/settings.local.json
  • 命令行参数
  • enterprise managed policy settings
    • /Library/Application Support/ClaudeCode/managed-settings.json
    • /etc/claude-code/managed-settings.json
    • C:\ProgramData\ClaudeCode\managed-settings.json
settings.json
{
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test:*)", "Read(~/.zshrc)"],
    "deny": ["Bash(curl:*)"],
    "ask": [],
    // Claude 可以访问的额外工作目录
    // /add-dir
    // --add-dir <path>
    "additionalDirectories": [],
    // default - 标准行为：首次使用每个工具时提示权限
    // acceptEdits - 自动接受会话的文件编辑权限
    // plan - 计划模式：Claude 可以分析但不能修改文件或执行命令
    // bypassPermissions - 跳过所有权限提示
    "defaultMode": "default",
    // 设置为 "disable" 可防止激活 bypassPermissions 模式
    "disableBypassPermissionsMode": "disable"
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  // 覆盖 Claude Code 使用的默认模型
  "model": "",
  "hooks": {},
  "apiKeyHelper": "",
  // 基于最后活动日期，本地保留聊天记录的天数
  "cleanupPeriodDays": 30,
  // 是否在 git 提交和拉取请求中包含 Claude 共同作者标记
  "includeCoAuthoredBy": true,
  "statusLine": { "type": "command", "command": "~/.claude/statusline.sh" },
  "forceLoginMethod": "claudeai",
  // 自动批准项目 .mcp.json 文件中定义的所有 MCP 服务器
  "enableAllProjectMcpServers": true,
  // 批准的 .mcp.json 文件中的特定 MCP 服务器列表
  "enabledMcpjsonServers": ["memory", "github"],
  // 拒绝的 .mcp.json 文件中的特定 MCP 服务器列表
  "disabledMcpjsonServers": ["filesystem"],
  // 修改 .aws 目录的自定义脚本
  "awsAuthRefresh": "aws sso login --profile myprofile",
  // 输出包含 AWS 凭据的 JSON 的自定义脚本
  "awsCredentialExport": "/bin/generate_aws_grant.sh"
}
  • 权限格式
    • Tool, Tool(optional-specifier)
  • Tool
    • Edit
    • Read
    • WebFetch
    • mcp__github
      • 整个 MCP
    • mcp__github__get_issue
      • 单个 MCP 工具
工具描述需要权限
Bash在环境中执行 shell 命令是
Edit对特定文件进行精确编辑是
Glob基于模式匹配查找文件否
Grep在文件内容中搜索模式否
LS列出文件和目录否
MultiEdit对单个文件原子性地执行多次编辑是
NotebookEdit修改 Jupyter 笔记本单元格是
NotebookRead读取并显示 Jupyter 笔记本内容否
Read读取文件内容否
Task运行子代理处理复杂的多步骤任务否
TodoWrite创建和管理结构化任务列表否
WebFetch从指定 URL 获取内容是
WebSearch执行带域名过滤的网络搜索是
Write创建或覆盖文件是
envfor
ANTHROPIC_API_KEYAPI 密钥，作为 X-Api-Key 头发送，Claude SDK 使用（交互式运行 /login）
ANTHROPIC_AUTH_TOKENAuthorization 头的自定义值（设置值将添加 Bearer 前缀）
ANTHROPIC_BASE_URL自定义 API 端点 URL
ANTHROPIC_CUSTOM_HEADERS添加到请求的自定义头（Name: Value 格式）
ANTHROPIC_MODEL要使用的自定义模型名称（如 claude-sonnet-4-20250514）
ANTHROPIC_SMALL_FAST_MODELHaiku 类模型名称，用于后台任务
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION使用 Bedrock 时小型快速模型的 AWS 区域覆盖
ANTHROPIC_BEDROCK_BASE_URLAWS Bedrock 端点 URL
ANTHROPIC_VERTEX_BASE_URLGoogle Vertex AI 端点 URL
ANTHROPIC_VERTEX_PROJECT_IDGoogle Cloud 项目 ID
AWS_BEARER_TOKEN_BEDROCKBedrock 认证的 API 密钥（参见 Bedrock API 密钥）
BASH_DEFAULT_TIMEOUT_MS长时间运行 bash 命令的默认超时时间（毫秒）
BASH_MAX_TIMEOUT_MS模型可设置的长时间运行 bash 命令的最大超时时间（毫秒）
BASH_MAX_OUTPUT_LENGTHbash 输出在被中间截断前的最大字符数
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR每次 Bash 命令后返回原始工作目录
CLAUDE_CODE_API_KEY_HELPER_TTL_MS凭据刷新间隔（毫秒），使用 apiKeyHelper 时
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁用非必要流量（等同于设置 DISABLE_AUTOUPDATER、DISABLE_BUG_COMMAND、DISABLE_ERROR_REPORTING 和 DISABLE_TELEMETRY）
CLAUDE_CODE_DISABLE_TERMINAL_TITLE设为 1 可禁用基于对话上下文的自动终端标题更新
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL跳过 IDE 扩展的自动安装
CLAUDE_CODE_MAX_OUTPUT_TOKENS设置大多数请求的最大输出令牌数
CLAUDE_CODE_SKIP_BEDROCK_AUTH跳过 Bedrock 的 AWS 认证（如使用 LLM 网关时）
CLAUDE_CODE_SKIP_VERTEX_AUTH跳过 Vertex 的 Google 认证（如使用 LLM 网关时）
CLAUDE_CODE_USE_BEDROCK使用 Bedrock
CLAUDE_CODE_USE_VERTEX使用 Vertex
DISABLE_AUTOUPDATER设为 1 可禁用自动更新，优先于 autoUpdates 配置设置
DISABLE_BUG_COMMAND设为 1 可禁用 /bug 命令
DISABLE_COST_WARNINGS设为 1 可禁用成本警告消息
DISABLE_ERROR_REPORTING设为 1 可选择退出 Sentry 错误报告
DISABLE_NON_ESSENTIAL_MODEL_CALLS设为 1 可禁用非关键路径（如风格化文本）的模型调用
DISABLE_TELEMETRY设为 1 可选择退出 Statsig 遥测（注意 Statsig 事件不包含代码、文件路径或 bash 命令等用户数据）
HTTP_PROXY指定网络连接的 HTTP 代理服务器
HTTPS_PROXY指定网络连接的 HTTPS 代理服务器
MAX_MCP_OUTPUT_TOKENSMCP 工具响应中允许的最大令牌数（默认：25000）
MAX_THINKING_TOKENS强制模型思考预算的令牌数
MCP_TIMEOUTMCP 服务器启动超时时间（毫秒）
MCP_TOOL_TIMEOUTMCP 工具执行超时时间（毫秒）
USE_BUILTIN_RIPGREP设为 0 可使用系统安装的 rg 而非 Claude Code 自带的 rg
VERTEX_REGION_CLAUDE_3_5_HAIKU使用 Vertex AI 时 Claude 3.5 Haiku 的区域覆盖
VERTEX_REGION_CLAUDE_3_5_SONNET使用 Vertex AI 时 Claude Sonnet 3.5 的区域覆盖
VERTEX_REGION_CLAUDE_3_7_SONNET使用 Vertex AI 时 Claude 3.7 Sonnet 的区域覆盖
VERTEX_REGION_CLAUDE_4_0_OPUS使用 Vertex AI 时 Claude 4.0 Opus 的区域覆盖
VERTEX_REGION_CLAUDE_4_0_SONNET使用 Vertex AI 时 Claude 4.0 Sonnet 的区域覆盖
VERTEX_REGION_CLAUDE_4_1_OPUS使用 Vertex AI 时 Claude 4.1 Opus 的区域覆盖
export ANTHROPIC_AUTH_TOKEN=sk-1234
export ANTHROPIC_BASE_URL=http://localhost:4000
export ANTHROPIC_MODEL=openrouter/qwen/qwen3-coder
export ANTHROPIC_SMALL_FAST_MODEL=openrouter/qwen/qwen3-coder

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# 等同于
export DISABLE_TELEMETRY=1
export DISABLE_ERROR_REPORTING=1
export DISABLE_BUG_COMMAND=1

CLAUDE.md​

  • ~/.claude/CLAUDE.md
  • CLAUDE.md
  • CLAUDE.local.md
  • “提示即程序”（Prompt as a Program）
  • 技术栈 (Tech Stack): 声明项目使用的语言、框架和工具及其版本。
  • 项目结构 (Project Structure): 概述关键目录的用途和组织方式。
  • 命令 (Commands): 列出重要的构建、测试、部署等 shell 命令。
  • 代码风格与约定 (Code Style & Conventions): 定义编码规范，如命名约定、导入顺序等。
  • 仓库礼仪 (Repository Etiquette): 说明分支命名规则、提交信息格式等版本控制流程。
  • 核心文件 (Core Files): 指向项目中关键的配置文件或实用工具模块。
  • 禁止触碰列表 (Do Not Touch): 明确指出 AI 不应修改的敏感文件或代码区域，如配置文件或遗留代码。
# Bash commands
- npm run build: Build the project
- npm run typecheck: Run the typechecker

# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you’re done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance
  • 工作流
    • 探索、计划、编码、提交
      • 探索：要求 Claude 阅读相关文件、图片或 URL，但明确指示它暂时不要编写代码。
      • 计划：让 Claude 制定一个计划。使用 "think"、"think hard" 或 "ultrathink" 等关键词可以为其分配更多计算时间进行深度思考 。
      • 编码：指示 Claude 根据计划实现解决方案。
      • 提交：让 Claude 提交结果、创建拉取请求 (Pull Request)，并更新相关文档。
    • 测试驱动开发 (TDD)
    • 可视化驱动开发

MCP​

  • 范围
    • local：个人服务器、实验性配置或特定于单个项目的敏感凭据
      • ~/.claude.json
    • project：团队共享的服务器、项目特定的工具或协作所需的服务
      • .mcp.json
    • user：跨多个项目需要的个人工具、开发工具或常用服务
  • .mcp.json 支持展开 ${VAR:-default}
    • command, args, env, url, headers
{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

settings.local.json​

settings.local.json
{
  "permissions": {
    "allow": [
      "Bash(cat:*)",
      "Bash(cp:*)",
      "Bash(find:*)",
      "Bash(git add:*)",
      "Bash(git checkout:*)",
      "Bash(git commit:*)",
      "Bash(git fetch:*)",
      "Bash(git merge:*)",
      "Bash(git log:*)",
      "Bash(git push:*)",
      "Bash(git rm:*)",
      "Bash(git stash:*)",
      "Bash(go build:*)",
      "Bash(go get:*)",
      "Bash(go mod:*)",
      "Bash(go test:*)",
      "Bash(ls:*)",
      "Bash(mkdir:*)",
      "Bash(npm run lint)",
      "Bash(npm run test:*)"
      "Bash(python3:*)",
      "Bash(true)",
      "WebFetch(domain:docs.anthropic.com)",
      "WebFetch(domain:github.com)",
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

.claude/commands​

Claude Code Router

npm install -g @musistudio/claude-code-router

ccr code   # 启动 Claude Code
ccr ui     # UI 模式
ccr status # 状态

FAQ

This organization has been disabled.​