在这里插入图片描述

朋友们，别再问了，Claude Code到底怎么用？今天来一份“全链路生存指南”，不藏私，细到毛孔，啰嗦到你嫌烦。你要的不是“入门”，是“活下去”，是“用到极致”！话糙理不糙，能落地。

目录

  1. Claude Code到底是个啥？
  2. 安装方法（别怕，命令全给你写明白）
  3. 基础使用（从0到1，别跳步）
  4. MCP集成（外部服务、数据库全搞定）
  5. 配置系统（全局、项目、环境变量，细节全在这）
  6. 安全和权限管理（别让AI乱动你家底）
  7. 思考模式（让Claude越想越深）
  8. config命令大全（配置随心改）
  9. 团队协作与自动化（CI/CD、pre-commit全流程）
  10. 高级特性（记忆、多目录、架构分析）

1. Claude Code到底是个啥？

别把它当成又一个AI IDE。Claude Code是命令行里的AI小机灵鬼，是你深夜debug时唯一的朋友。和那些花里胡哨的IDE比，它有这些硬核优势：

核心痛点 传统AI IDE Claude Code (CLI)
AI能力 被阉割，回答质量差 原生Claude 4 Sonnet/Opus，聪明到飞起
工具调用 25次就掐断 无限调用，想咋用咋用
上下文 窗口小，项目大就懵 200K+上下文，项目再大都能装下
Agent能力 任务一长就掉线 完全自主，能自己干到底
调试 只能看代码 直接读系统日志，查问题一针见血

2. 安装方法（别怕，命令全给你写明白）

⚠️注意

Claude官方不支持中国大陆用户，推荐用国内镜像站。两种方式都能用，命令全给你写明白。

2.1 镜像站安装

  • 邀请链接
    https://aicodewith.com/?invitation=EK1S5F
  • MacOS
    curl -fsSL https://aicodewith.com/claudecode/resources/install-script-macos | bash
  • Linux
    curl -fsSL https://aicodewith.com/claudecode/resources/install-script-linux | bash
  • Windows
    不支持原生，必须用WSL（Windows 11 Pro/Workstation/Enterprise，BIOS/UEFI虚拟化要开）
    1. 安装WSL2：wsl --install
    2. 微软商店装Ubuntu
    3. 一键脚本：curl -fsSL https://aicodewith.com/claudecode/resources/install-script-wsl | bash

2.2 官方安装

  • NPM全局安装（Windows也得在WSL里装）
    npm install -g @anthropic-ai/claude-code
  • 验证版本
    claude --version

3. 基础使用（从0到1，别跳步）

3.1 首次配置

  1. API Key配置（镜像站不用管，官方装的要去官网拿key）
    export ANTHROPIC_API_KEY="sk-your-key-here"

    • Bash:
      echo 'export ANTHROPIC_API_KEY="sk-your-key-here"' >> ~/.bashrc && source ~/.bashrc
    • Zsh:
      echo 'export ANTHROPIC_API_KEY="sk-your-key-here"' >> ~/.zshrc && source ~/.zshrc
    • Fish:
      echo 'set -gx ANTHROPIC_API_KEY "sk-your-key-here"' >> ~/.config/fish/config.fish

  2. 基本配置

    • 改默认模型：claude config set -g model claude-sonnet-4
    • 开详细输出：claude config set -g verbose true
    • 改输出格式：claude config set -g outputFormat text
    • 测试安装：claude "Hello, Claude!" 或 claude /doctor

  3. 安全设置（有风险，自行选择）

    • 不发统计：export DISABLE_TELEMETRY=1
    • 不报错日志：export DISABLE_ERROR_REPORTING=1
    • 节约token：export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
    • 限制工具：claude config set allowedTools "Edit,View"
    • 跳过信任对话框：claude config set hasTrustDialogAccepted
    • 跳过项目引导：claude config set hasCompletedProjectOnboarding
    • 忽略敏感文件：claude config set ignorePatterns
    • 全局设置：claude config set --global

3.2 基本命令

  • 启动：claude
  • 修bug：claude "帮我修复这个 bug"
  • 单次打印：claude -p ""
  • 读大文件：cat file | claude -p ""
  • 更新：claude update
  • 启动MCP：claude mcp
对话命令
  • 续上次对话：claude -c
  • 按ID恢复：claude -r
  • 长对话恢复：claude --resume
  • 自定义名恢复：claude --resume
快捷命令（斜杠命令）
  • /help：列出所有命令
  • /add-dir：加更多工作目录
  • /bug：报错
  • /clear：清除聊天记录
  • /compact：压缩上下文
  • /config：配置菜单
  • /cost：token花费统计
  • /doctor：完整性检查
  • /exit：退出
  • /init：初始化项目，生成CLAUDE.md
  • /mcp：看MCP列表和状态
  • /memory：编辑记忆
  • /model：换模型
  • /permissions：改工具权限
  • /pr_comments：看PR评论
  • /review：请求代码审查
  • /sessions：列出sessions
  • /status：系统/账户状态
  • /terminal-setup：装Shift+Enter绑定
  • /vim：切换vim模式

4. MCP集成（外部服务、数据库全搞定）

MCP让Claude能连外部服务、数据库、API、工具，功能直接拉满。

  • 注意：所有MCP安装都得在终端命令行搞，不能在软件里点点鼠标。

4.1 基本MCP命令

  • 列服务：claude mcp list
  • 加服务：claude mcp add
  • 删服务：claude mcp remove
  • 配置文件：~/.claude.json

4.2 常用MCP服务（选装）

  • Git MCP
    npm install -g git-mcp-server
    claude mcp add git "git-mcp-server"
    claude mcp add github "github-mcp-server --token $GITHUB_TOKEN"

  • 数据库MCP
    npm install -g postgres-mcp-server
    npm install -g mysql-mcp-server
    npm install -g sqlite-mcp-server
    export POSTGRES_URL="postgresql://user:password@localhost:5432/mydb"
    claude mcp add postgres "postgres-mcp-server --url $POSTGRES_URL"

  • MCP工具权限

    • 指定权限：claude --allowedTools "mcp__git__commit,mcp__git__push"
    • 关键词权限：claude --allowedTools "mcp__postgres__*"
    • 结合内置工具：claude --allowedTools "Edit,View,mcp__git__*"

5. 配置系统（全局、项目、环境变量，细节全在这）

5.1 配置文件

  • 全局配置：~/.claude.json，全局生效 
    {
  "model": "claude-sonnet-4",
  "verbose": true,
  "outputFormat": "text",
  "allowedTools": ["Edit", "View"],
  "disallowedTools": []
}
  • 项目配置：settings.json或类似名，只在项目目录生效 
    {
  "model": "claude-sonnet-4",
  "systemPrompt": "You are a senior developer working on this project",
  "allowedTools": [
    "Edit",
    "View",
    "Bash(git:)",
    "Bash(npm:*)"
  ]
}

5.2 环境变量

变量名 默认值 作用
DISABLE_NON_ESSENTIAL_MODEL_CALLS 0 跳过自动摘要/背景解释/git diff，省token
MAX_THINKING_TOKENS ≈30‑40k 最大思考token花费
DISABLE_TELEMETRY 0 是否发统计和错误日志
CLAUDE_CODE_USE_BEDROCK 0 用AWS Bedrock验证账号
CLAUDE_CODE_USE_VERTEX 0 用Google Vertex AI验证账号
HTTP_PROXY unset HTTP代理
HTTPS_PROXY unset HTTPS代理
NO_PROXY localhost 绕过代理的主机/IP

6. 安全和权限管理（别让AI乱动你家底）

6.1 权限系统

  • 工具用前要授权
  • 每个会话记住权限
  • 危险操作要确认
级别 描述 风险
Interactive 每次操作都问 低
Allowlist 只让用指定工具 中
Dangerous 全部放开 高
应用案例
  • 只给Edit、View权限：claude --allowedTools "Edit,View"
  • 给一组权限：claude --allowedTools "Edit,View,Bash"
  • 只给git相关：claude --allowedTools "Bash(git:*)"
  • 多范围权限：claude --allowedTools "Bash(git:*),Bash(npm:*)"
  • 完全放开（慎用）：claude --dangerously-skip-permissions

6.2 推荐安全策略

  1. 限制具体工具权限

    • 推荐：claude --allowedTools "Edit,View,Bash(git:status)"
    • 不推荐：claude --allowedTools "Bash"

  2. 保护敏感数据

    • 推荐：用环境变量
      export DATABASE_URL="postgresql://user:pass@host/db"
    • 不推荐：命令里写死密码
      claude "connect to postgresql://user:password123@host/db"

  3. 定期审查权限组

    • 查权限：claude config get allowedTools
    • 查禁用权限：claude config get disallowedTools
    • 查全部配置：claude config list

7. 思考模式（让Claude越想越深）

通过prompt关键字控制Claude的“思考深度”：

深度 关键词
1 think
2 think about it, think a lot, think deeply, think hard, think more, megathink
3 think harder

例子：
claude -p "We have a tricky concurrency bug. ultrathink and propose a fix."
（关键字随便放哪，最高优先级生效）

8. config命令大全（配置随心改）

命令 功能 用例
claude config list 显示所有设置 claude config list
claude config get 查具体设置 claude config get theme
claude config set -g 全局设置 claude config set -g theme dark
claude config add -g 数组类型加值 claude config add -g env CLAUDE_CODE_ENABLE_TELEMETRY=1
claude config remove -g 数组类型删值 claude config remove -g env CLAUDE_CODE_ENABLE_TELEMETRY

常用key举例：

Key 常用值 用例 说明
apiKeyHelper 脚本路径 claude config set -g apiKeyHelper ~/.claude/key_helper.sh 自动换API key
installMethod npm claude config set -g installMethod npm 安装方式
autoUpdates true/false claude config set -g autoUpdates false 自动更新开关
theme dark claude config set -g theme dark 主题
verbose true claude config set -g verbose true 输出详细
… … … …

9. 团队协作与自动化（CI/CD、pre-commit全流程）

9.1 CI/CD集成（GitHub Actions）

每次PR自动审查，自动部署，Claude帮你把关。

核心配置：

name: Claude Code Review
on:
  pull_request:
    branches: [main, develop]
jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js 18
        uses: actions/setup-node@v4
        with:
          node-version: '18'
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Review PR
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "Review changes for security issues and bugs" \
            --allowedTools "View" \
            --output-format json > review-results.json
      - name: Upload results artifact
        uses: actions/upload-artifact@v4
        with:
          name: claude-review
          path: review-results.json

关键点：

  • actions/checkout@v4：拉取PR差异
  • @anthropic-ai/claude-code：官方CLI
  • ANTHROPIC_API_KEY：加密存储
  • –allowedTools “View”：只读，防止乱写
  • –output-format json：结构化输出

9.2 本地git自动化（pre-commit hook）

让Claude帮你在commit前查大坑，关键代码如下：

#!/usr/bin/env bash
# .git/hooks/pre-commit (chmod +x)
staged=$(git diff --cached --name-only --diff-filter=ACM)
[ -z "$staged" ] && exit 0
payload=$(echo "$staged" | xargs cat)
analysis=$(echo "$payload" | \
  claude -p "Review these changes for issues before commit" \
    --allowedTools "View" \
    --output-format json)
if echo "$analysis" | jq -e '.critical_issues[]' >/dev/null 2>&1; then
  echo "❌ Critical issues found – commit blocked"
  exit 1
fi
echo "✅ Claude analysis passed"

10. 高级特性（记忆、多目录、架构分析）

10.1 持久化记忆

  • /init生成CLAUDE.md，让Claude记住你的项目
  • 例子： 
    Project: My Application
Overview
This is a React/Node.js application with PostgreSQL database.
Architecture
Frontend: React 18 with TypeScript
Backend: Node.js with Express
Database: PostgreSQL 14
Current Goals
Implement authentication
Add API documentation
Set up CI/CD pipeline
Development Guidelines
Use TypeScript for all new code
Follow ESLint configuration
Write tests for new features

10.2 Memory命令

  • 编辑记忆：claude /memory
  • 查看记忆：claude /memory view

10.3 多目录工作区

  • 加多个目录：claude --add-dir ../frontend ../backend ../shared
  • 全局分析：claude "analyze the entire application architecture"

结语

这份指南细到你想不到，命令全给你写明白，坑全帮你踩过。工具嘛，关键是用得顺手，别让它反过来折腾你。你们是怎么高效使用Claude Code的？评论区分享讨论吧！

国内镜像链接
https://aicodewith.com/?invitation=EK1S5F
Logo
火山引擎 ADG 社区

火山引擎开发者社区是火山引擎打造的AI技术生态平台，聚焦Agent与大模型开发，提供豆包系列模型（图像/视频/视觉）、智能分析与会话工具，并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长，新用户可领50万Tokens权益，助力构建智能应用。

更多推荐

OpenClaw 本地部署完整指南（Windows + Ollama）

本文档基于实际部署经验编写，旨在帮助你在 Windows 系统上从零开始搭建 OpenClaw，并连接本地 Ollama 模型（如 Qwen2.5 或 Qwen3），使其具备完整的智能体能力。文档包含了所有关键步骤以及常见问题的解决方案。

avatar 火山引擎 ADG 社区

OpenClaw 小白安装指南（Windows版）

（类似一个能自动执行任务的AI机器人），不是游戏。API Key只保存在你本地电脑的加密文件里，不会上传到任何地方。访问：https://github.com/miaoxworld/openclaw-manager/releases。: 一键安装脚本会自动安装Node.js 22+，如果失败，手动下载安装：https://nodejs.org/：在PowerShell中，鼠标右键就是粘贴，不需要按

avatar 火山引擎 ADG 社区

飞书 × OpenClaw 接入指南：不用服务器，用长连接把机器人跑起来

这个项目存在的意义，就是把“飞书接 OpenClaw”这件事，整理成一套的配置入口，并把官方文档没覆盖到的坑集中写成排查清单。先说清楚它的角色：OpenClaw 现在已经内置官方飞书插件 @openclaw/feishu，功能更完整、维护也更及时。，说明飞书 + AI 的接入已经走通。另外，仓库也推荐了一个新项目：把 OpenClaw 变成“多 Agent 团队”，用多个 Agent 分工，Sla

avatar 火山引擎 ADG 社区