这可能是目前最全的《Claude code使用指南》

最近有不少听闻cc的大名跑来上手新工具的朋友，但是cil的页面让不少对命令行不熟悉的朋友感到疑惑。不知道如何下手。

今天笔者在这里分享一下我根据官方文档整理出的所有使用技巧，内容很长，建议作为工具书使用：

目录：

1. [Claude Code 简介]
2. [安装方法]
3. [基础使用]
4. [MCP 集成]
5. [配置系统]
6. [安全和权限管理系统]
7. [思考模式]
8. [congfig 命令]
9. [团队协作git自动化审查和部署指南]
10. [高级特性]

主要内容： – 六种不同平台的详细安装方法，包括 Docker 和源码编译 – MCP 集成完整指南，连接外部服务和数据库的配置教程   – 完整的命令参考表，覆盖 CLI 命令和交互模式斜杠命令 – 安全权限管理和最佳实践，避免数据泄露风险 – 自动化脚本示例，适用于 CI/CD 和团队协作场景 – 详细的故障排除指南，快速解决常见配置问题

按照指南步骤即可快速上手，想要深度使用 Claude Code 的开发者不妨看下。

Claude Code 不是又一个 AI IDE，而是革命性的 CLI 智能编程助手！

⚠️注意：Claude官方不支持中国大陆用户使用他们的服务，因此这里更推荐使用国内镜像站，两者使用上并无任何差别。这里两种方式均会介绍。

2.1 镜像站安装：

地址：Claude Code Dashboard – 官方API镜像服务

注册好账号后，根据教程一键安装即可：

这里将命令也写出来

• MACOS：
• Linux:
• Windows: Claude Code 不支持 Windows 文件系统，必须在 WSL 环境中运行,系统要求Windows 11 Pro/Workstation/Enterprise 已启用 BIOS/UEFI 虚拟化。

#安装 WSL2 wsl --install #然后在微软商店搜索并安装 Ubuntu 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.1 首次配置

1、api配置（镜像站跳过）

# 从官网 https://console.anthropic.com 获取api keyexport ANTHROPIC_API_KEY="sk-your-key-here"# 根据你的shell选择# Bashecho 'export ANTHROPIC_API_KEY="sk-your-key-here"' >> ~/.bashrcsource ~/.bashrc# Zshecho 'export ANTHROPIC_API_KEY="sk-your-key-here"' >> ~/.zshrcsource ~/.zshrc# Fishecho '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                 #Claude Code 不会发送使用统计、性能数据等信息给 Anthropic export DISABLE_ERROR_REPORTING=1           #当 Claude Code 崩溃或出错时，不会自动发送错误日志给 Anthropic export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1 #禁用非必要的模型调用，节约token Security defaults claude config set allowedTools "Edit,View" #限制 Claude 只可以使用edit和view工具 claude config set hasTrustDialogAccepted   #跳过信任对话框 claude config set hasCompletedProjectOnboarding       #跳过项目引导流程 claude config set ignorePatterns           #设置忽略的文件/目录，防止读取敏感文件 claude config set --global                 #全局设置需要指定具体配置的参数

3.2 基本命令：

1、基础交互：

claude                           # 启动软件claude "帮我修复这个 bug"          # 一次性命令执行claude -p " 
 
   "             #单次打印模式 cat file | claude -p " 
  
    "  #大文件读取 claude update                    #更新客户端，镜像站更新重新运行下载的命令即可 claude mcp                       #启动mcp向导 
   
 

2、对话命令：

claude -c              #继续上次对话 claude -r  
 
            #按会话 ID 恢复对话 claude --resume  
  
       #长对话恢复对话 claude --resume  
   
      #按照自定义的名字恢复对话 
    
   
 

3、快捷命令：

/help          # 列出所有斜线命令/add-dir       #添加更多工作目录/bug           #向 Anthropic 报告错误/clear         #清除聊天记录/compact       #压缩上下文/config        #配置菜单/cost          #toekn花费统计/doctor        #客户端完整性检查/exit          # 退出 Claude Code/init          #初始化项目，生成 CLAUDE.md全局记忆/mcp           #查看mcp列表和状态/memory        #编辑记忆/model         #更换模型/permissions   #修改工具权限/pr_comments   #查看PR评论/review        #请求代码审查/sessions      #列出sessions列表/status        #系统/账户状态/terminal-setup #安装 Shift+Enter 绑定/vim           #切换 vim 模式

MCP 通过连接外部服务、数据库、API 和工具扩展了 Claude 的功能。

注意：所有的mcp安装均需要在终端命令行页面进行，不可以在软件内部设置

4.1 基本的mcp命令

claude mcp list              # 列出现有的mcp服务             claude mcp add  
 
     
  
      # 添加新的mcp claude mcp remove  
   
          # 移除mcp 
    
   
 

MCP 配置文件位置 ：

4.2 常用的一些mcp服务（选装）

⚠️注意：以下软件包名称和安装命令可能不准确。请参阅 MCP 官方文档了解当前服务器软件包信息。

1、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"

2、数据库mcp

npm install -g postgres-mcp-server    npm install -g mysql-mcp-server                   npm install -g sqlite-mcp-server                #Setup examples export POSTGRES_URL="postgresql://user:password@localhost:5432/mydb" claude mcp add postgres "postgres-mcp-server --url $POSTGRES_URL"

3、mcp工具权限

#赋予特定mcp权限 claude --allowedTools "mcp__git__commit,mcp__git__push" #赋予特定关键词mcp权限 claude --allowedTools "mcp__postgres__*" #将mcp与内置工具结合 claude --allowedTools "Edit,View,mcp__git__*"

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 环境变量

6.1 权限系统

工作场景：

• 在使用工具前请求许可
• 每个会话都会记住权限
• 危险操作需要确认

1、权限级别

2、应用案例

工具权限管理：

给予具体工具权限 claude --allowedTools "Edit,View" 给予一组工具权限 claude --allowedTools "Edit,View,Bash" 范围权限赋予 (仅git操作) claude --allowedTools "Bash(git:*)" 多范围权限赋予 claude --allowedTools "Bash(git:*),Bash(npm:*)"

完全权限模式：

⚠️注意：使用这个模式cc将不再向你索要任何权限，会直接修改它觉得需要修改的所有文件！

6.2 推荐的安全策略

1️⃣  限制具体的工具权限

#Good: Specific permissions claude --allowedTools "Edit,View,Bash(git:status)" #Bad: Broad permissions claude --allowedTools "Bash"

2️⃣ 保护敏感数据

#Good: Environment variables export DATABASE_URL="postgresql://user:pass@host/db" #Bad: Hardcoded credentials in commands claude "connect to postgresql://user:password123@host/db"

3️⃣ 定期审查权限组

#Check current permissions claude config get allowedTools claude config get disallowedTools #Review configuration claude config list

可以通过设置prompt，来加深思考的深度

example：

• 关键字可以出现在提示中的任何位置
• 如果存在多个关键字， 则最高层级优先

注：-g 参数的含义是全局设置，若不加-g则仅为当前项目设置

可编辑的

9.1 CI/CD 集成

所谓的CI/CD即自动化检查和自动化部署，通过集成到Git中，即可在每次提交代码时让cc做自动化审查，和服务器自动化部署。

GitHub 操作

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

关键点：

9.2 本地git自动化

Pre‑commit Hook：

#!/usr/bin/env bash .git/hooks/pre-commit (chmod +x) Abort if nothing staged staged=$(git diff --cached --name-only --diff-filter=ACM) [ -z "$staged" ] && exit 0 Aggregate staged file contents payload=$(echo "$staged" | xargs cat) analysis=$(echo "$payload" |    claude -p "Review these changes for issues before commit"      --allowedTools "View"      --output-format json) Block commit on critical issues 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"

9.3 常见模式

10.1 持久化记忆

CLAUDE.md – 由/init产生和更新，位于项目根目录。可以让 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 命令

Memory 命令就是给 Claude Code 提供”长期记忆”的功能，让它能够记住你的项目特点、编程习惯和重要信息

claude /memory           # Edit project memory claude /memory view      # View current memory

10.3多目录工作区

#Add multiple directories claude --add-dir ../frontend ../backend ../shared #Project-wide analysis claude "analyze the entire application architecture"