对于不少刚接触 Claude Code（简称 CC）的开发者来说，命令行界面（CLI）可能会让人感到陌生。本文基于官方文档，整理了一套全面的使用指南，涵盖安装、基础操作、高级功能等内容，适合作为工具书随时查阅。

一、Claude Code 是什么？

Claude Code 并非传统的 AI 集成开发环境（IDE），而是一款颠覆性的命令行智能编程助手。它与 Cursor 等 AI IDE 相比，在核心能力上有显著优势：

核心能力	普通 AI IDE	Claude Code（CLI）
AI 功能完整性	受成本限制，提示词能力被弱化，回答质量一般	基于原生 Claude 4 Sonnet/Opus，无功能阉割
工具调用次数	仅限 25 次，复杂任务易中断	无限次工具调用，支持复杂任务连贯执行
上下文窗口	窗口较小，难以完整理解大项目	超长上下文容量，可覆盖整个项目
自主执行能力	长任务易中断，无法独立完成	全自主 Agent，可从头到尾自动执行任务
调试能力	仅能查看代码，无法获取系统状态	直接读取系统日志，支持实时调试

二、安装步骤

注意：Claude 官方暂不支持中国大陆用户直接使用，推荐通过国内镜像站安装，功能与官方版本一致。以下两种方式均会介绍。

2.1 镜像站安装

镜像站地址：https://myclaudecode.com

注册账号后，可通过以下命令一键安装：

macOS：
curl -fsSL https://myclaudecode.com/scripts/env-install.sh| bash
Linux：
curl -fsSL https://myclaudecode.com/scripts/env-install.sh | bash

windows安装

1. 访问网站：https://nodejs.org/zh-cn/download 
下载 nodejs，默认路径安装到全局。

2.cmd + r 打开命令行，
输入:node -v 和 npm -v 确认安装情况。

3.安装官方版本：
npm install -g @anthropic-ai/claude-code

4. 到控制面板设置环境变量：
ANTHROPIC_BASE_URL=https://api.myclaudecode.com
ANTHROPIC_API_KEY=值为你的密钥。
ANTHROPIC_AUTH_TOKEN=值为你的密钥。

2.2 官方安装（需非大陆环境）

通过 NPM 全局安装

# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装版本
claude --version

三、基础操作指南

3.1 配置

（1）API 配置（镜像站用户可跳过）

从 Anthropic 控制台 获取 API Key 后，根据所用 Shell 配置环境变量：

# 临时设置 API 
Keyexport ANTHROPIC_API_KEY="sk-your-key-here"
# 永久生效（根据 Shell 选择）
# 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-sonnet-4（全局生效）
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 ignorePatterns  # 设置需忽略的敏感文件/目录

3.2 常用命令

（1）基础交互命令

claude  # 启动 Claude Code 交互模式
claude "帮我修复这个代码漏洞"  # 直接执行单次命令
claude -p "<提示内容>"  # 单次打印模式（不进入交互）
cat 文件名 | claude -p "<提示内容>"  # 读取大文件并处理
claude update  # 更新客户端（镜像站用户需重新运行安装脚本）
claude mcp  # 启动外部服务集成向导

（2）对话管理命令

claude -c  # 继续上次未完成的对话
claude -r <会话ID>  # 通过会话 ID 恢复对话
claude --resume <名称>  # 通过自定义名称恢复对话

（3）快捷命令（斜杠命令）

在交互模式中，可使用以下快捷命令：  
/help：查看所有斜杠命令列表  
/add-dir：添加额外的工作目录  
/clear：清空当前聊天记录  
/config：打开配置菜单  
/cost：查看 Token 消耗统计  
/exit：退出 Claude Code  
/init：初始化项目（生成 CLAUDE.md 持久化记忆）  
/model：切换 AI 模型  
/review：请求代码审查  
/sessions：列出所有会话记录 

四、MCP 外部服务集成

MCP（Module for Connecting Plugins）是 Claude Code 连接外部服务、数据库、API 的核心模块，能极大扩展其功能范围。

4.1 基础 MCP 命令

claude mcp list  # 列出现已集成的 MCP 服务
claude mcp add <名称> <命令>  # 添加新的 MCP 服务
claude mcp remove <名称>  # 移除指定 MCP 服务

MCP 配置文件位置：~/.claude.json

4.2 常用 MCP 服务配置（选装）

注意：以下软件包名称可能随版本更新变化，建议参考 MCP 官方文档确认。

（1）Git 相关集成

# 安装 Git MCP 服务
npm install -g git-mcp-server
# 添加 Git 集成（基础版）
claude mcp add git "git-mcp-server"
# 添加 GitHub 集成（需 GitHub Token）
claude mcp add github "github-mcp-server --token $GITHUB_TOKEN"

（2）数据库集成

# 安装对应数据库的 MCP 服务
npm install -g postgres-mcp-server  # PostgreSQL
npm install -g mysql-mcp-server     # MySQL
npm install -g sqlite-mcp-server    # SQLite
# 配置 PostgreSQL 示例（需先设置数据库地址）
export POSTGRES_URL="postgresql://用户:密码@localhost:5432/数据库名"
claude mcp add postgres "postgres-mcp-server --url $POSTGRES_URL"

4.3 MCP 权限管理

# 允许特定 MCP 操作（如 git 的 commit 和 push）
claude --allowedTools "mcp__git__commit,mcp__git__push"
# 允许某类 MCP 的所有操作（如 postgres 相关）
claude --allowedTools "mcp__postgres__*"
# 结合内置工具与 MCP 权限
claude --allowedTools "Edit,View,mcp__git__*"

五、配置系统详解

Claude Code 的配置通过文件和环境变量实现，支持全局和项目级别的个性化设置。

5.1 配置文件

• 全局配置文件：~/.claude.json，修改后对所有项目生效。示例：

{  
"model": "claude-sonnet-4",  
"verbose": true, 
"outputFormat": "text",  
"allowedTools": ["Edit", "View"]
}

• 项目配置文件：在项目根目录下（如 settings.json），仅对当前项目生效。示例：

{  
"model": "claude-sonnet-4",  
"systemPrompt": "你是该项目的资深开发顾问",  
"allowedTools": ["Edit", "View", "Bash(git:*)"]
}

5.2 关键环境变量

变量名	默认值	功能描述
DISABLE_NON_ESSENTIAL_MODEL_CALLS	0	设为 1 时，跳过自动摘要、git diff 扫描等，节约 Token 并加快启动速度
MAX_THINKING_TOKENS	约 30-40k	限制最大思考 Token 消耗
DISABLE_TELEMETRY	0	设为 1 时，不向 Anthropic 发送使用统计和错误日志
HTTP_PROXY / HTTPS_PROXY	未设置	配置 HTTP/HTTPS 代理，用于网络环境受限的场景
NO_PROXY	localhost,127.0.0.1	绕过代理的主机/IP 列表（逗号分隔）

六、安全与权限管理

Claude Code 提供了细致的权限管理机制，可根据场景平衡便利性与安全性。

6.1 权限级别

级别	描述	风险程度
交互模式	每次操作需用户确认	低
允许列表模式	仅预先批准的工具可使用	中
危险模式	跳过所有权限检查，直接执行	高

6.2 权限配置示例

# 允许使用 Edit 和 View 工具
claude --allowedTools "Edit,View"
# 允许 Edit、View 及所有 git 相关 Bash 操作
claude --allowedTools "Edit,View,Bash(git:*)"
# 启用危险模式（谨慎使用！）
claude --dangerously-skip-permissions

6.3 安全最佳实践

1. 精确授权：避免赋予过宽权限，例如仅允许 Bash(git:status) 而非整个 Bash 工具。

2. 保护敏感数据：通过环境变量传递凭证（如 export DATABASE_URL="..."），而非直接在命令中明文写入。

3. 定期审查权限：

claude config get allowedTools  # 查看当前允许的工具
claude config list  # 检查所有配置项

七、思考模式调整

通过在提示词中加入特定关键词，可调整 Claude 的思考深度，从基础分析到深度推理不等：

思考深度	关键词示例
基础思考	think
中等深度	think about it、think deeply、megathink
深度分析	think harder、utrathink、think very hard

示例：
claude -p "这个并发漏洞很棘手，ultrathink 并提出修复方案。"

通过以上内容，你可以快速掌握 Claude Code 的核心功能与高级技巧。无论是个人开发还是团队协作，合理利用这款工具都能显著提升编程效率。