(碎碎念加强版)
朋友们,别再问了,Claude Code到底怎么用?今天来一份”全链路生存指南”,不藏私,细到毛孔,啰嗦到你嫌烦。你要的不是”入门”,是”活下去”,是”用到极致”!话糙理不糙,能落地。
目录
-
- Claude Code到底是个啥?
-
- 安装方法(别怕,命令全给你写明白)
-
- 基础使用(从0到1,别跳步)
-
- MCP集成(外部服务、数据库全搞定)
-
- 配置系统(全局、项目、环境变量,细节全在这)
-
- 安全和权限管理(别让AI乱动你家底)
-
- 思考模式(让Claude越想越深)
-
- config命令大全(配置随心改)
-
- 团队协作与自动化(CI/CD、pre-commit全流程)
-
- 高级特性(记忆、多目录、架构分析)
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虚拟化要开)
-
- 安装WSL2:
wsl --install
- 安装WSL2:
-
- 微软商店装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. 基础使用(从0到1,别跳步)
3.1 首次配置
-
- API Key配置(镜像站不用管,官方装的要去官网拿key)
export ANTHROPIC_API_KEY="sk-your-key-here"
- API Key配置(镜像站不用管,官方装的要去官网拿key)
- • 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
-
- 基本配置
- • 改默认模型:
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
-
- 安全设置(有风险,自行选择)
- • 不发统计:
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-serverclaude mcp add git "git-mcp-server"claude mcp add github "github-mcp-server --token $GITHUB_TOKEN" - • 数据库MCP
npm install -g postgres-mcp-servernpm install -g mysql-mcp-servernpm install -g sqlite-mcp-serverexport 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 推荐安全策略
-
- 限制具体工具权限
- • 推荐:
claude --allowedTools "Edit,View,Bash(git:status)" - • 不推荐:
claude --allowedTools "Bash"
-
- 保护敏感数据
- • 推荐:用环境变量
export DATABASE_URL="postgresql://user:pass@host/db" - • 不推荐:命令里写死密码
claude "connect to postgresql://user:password123@host/db"
-
- 定期审查权限组
- • 查权限:
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: ClaudeCodeReview
on:
pull_request:
branches: [main, develop]
jobs:
claude-review:
runs-on:ubuntu-latest
steps:
-uses:actions/checkout@v4
-name:SetupNode.js18
uses:actions/setup-node@v4
with:
node-version:'18'
-name:InstallClaudeCode
run:npminstall-g@anthropic-ai/claude-code
-name:ReviewPR
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:Uploadresultsartifact
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)
ifecho"$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的?评论区分享讨论吧!