📖 前言

Claude CLI 是 Anthropic 官方推出的强大命令行工具，让 AI 辅助编程变得前所未有的简单。

但是，在国内使用 Claude 面临着账号不稳定、频繁被风控的问题。经过长时间的实践，我找到了最稳定的解决方案。

💡  weelinking 中转服务 → 🔗 点击直达注册

话不多说，下面进入正式教程。

---

📑 目录

• 简介

• 安装

• 快速开始

• 基本使用

• 常用命令

• 高级功能

• 配置选项

• IDE 集成

• 最佳实践

---

💡 简介

Claude Code 是 Anthropic 官方提供的命令行工具，让你可以在终端中与 Claude AI 进行交互，帮助你完成各种软件工程任务。

主要功能

• 代码编写和修改

• Bug 调试和修复

• 代码重构

• 文档生成

• 文件操作

• Git 集成

• 测试执行

---

📦 安装

⚙️ 前置要求

• Node.js 18 或更高版本

• npm 或 yarn 包管理器

安装步骤

# 使用 npm 全局安装
npm install -g @anthropic/claude-code

# 或使用 yarn
yarn global add @anthropic/claude-code

验证安装

claude --version

🔑 配置 API Key

方式一：使用 weelinking 中转服务（推荐）⭐

🔗 点击 weelinking 获取 API Key

使用 weelinking 中转服务，稳定可靠，按量付费：

# Linux/Mac
export ANTHROPIC_BASE_URL="https://api.weelinking.com"
export ANTHROPIC_AUTH_TOKEN="你的_WEELINKING_API_KEY"

# Windows (PowerShell) - 临时设置
$env:ANTHROPIC_BASE_URL="https://api.weelinking.com"
$env:ANTHROPIC_AUTH_TOKEN="你的_WEELINKING_API_KEY"

# Windows (PowerShell) - 永久设置（推荐）
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.weelinking.com', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '你的_WEELINKING_API_KEY', 'User')

⚠️ 注意：永久设置后需要重启 PowerShell 才能生效

方式二：使用官方 API

首次运行时，Claude CLI 会提示你输入 API key：

claude

你也可以手动设置环境变量：

# Linux/Mac
export ANTHROPIC_API_KEY=your_api_key_here

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY="your_api_key_here"

---

⚡ 快速开始

🎯 启动 Claude CLI

在项目目录中运行：

claude

第一次对话

你: 帮我创建一个 Python 函数来计算斐波那契数列

Claude 会自动创建文件并编写代码。

退出

/exit

或按 Ctrl+C 两次。

---

🛠️ 基本使用

📁 文件操作

读取文件

你: 读取 main.py 文件的内容

编辑文件

你: 修改 main.py 中的 calculate 函数，添加错误处理

创建文件

你: 创建一个新的配置文件 config.json

🔄 Git 操作

查看状态

你: 检查 git 状态

创建提交

你: 创建一个 git commit 来保存这些更改

创建 Pull Request

你: 创建一个 PR 来合并这些更改

---

🎮 常用命令

Claude CLI 支持以下斜杠命令（Slash Commands）：

📌 基础命令

命令	说明	示例
/help	显示帮助信息	/help
/clear	清除对话历史	/clear
/exit	退出 CLI	/exit
/reset	重置会话	/reset

💻 代码相关

命令	说明	示例
/commit	创建 git commit	/commit
/commit -m "message"	带消息创建 commit	/commit -m "修复登录bug"
/review-pr [number]	审查 Pull Request	/review-pr 123

⚙️ 配置命令

命令	说明	示例
/settings	打开设置	/settings
/model	切换模型	/model opus

---

🚀 高级功能

1. 📋 任务规划（Plan Mode）

对于复杂任务，Claude 会进入规划模式，先制定计划再执行：

你: 重构整个认证系统，使用 JWT 替代 session

Claude 会：

1. 分析现有代码

2. 制定实施计划

3. 等待你的批准

4. 执行计划

2. ⚡ 并行任务

Claude 可以同时执行多个独立任务：

你: 同时运行测试和 lint 检查

3. 🔗 Hooks（钩子）

在 ~/.config/claude/settings.json 中配置钩子：

{
  "hooks": {
    "beforeCommit": "npm run lint",
    "afterEdit": "npm test",
    "beforePush": "npm run build"
  }
}

4. 🔌 MCP 服务器

MCP (Model Context Protocol) 服务器可以扩展 Claude 的功能。

配置 MCP 服务器

在 ~/.config/claude/mcp.json 中：

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      }
    }
  }
}

常用 MCP 服务器

• filesystem: 文件系统访问

• github: GitHub 集成

• postgres: PostgreSQL 数据库

• sqlite: SQLite 数据库

• brave-search: Brave 搜索引擎

---

⚙️ 配置选项

📝 设置文件位置

• Linux/Mac: ~/.config/claude/settings.json

• Windows: %APPDATA%\claude\settings.json

常用配置选项

{
  "model": "claude-sonnet-4-5",
  "maxTokens": 8000,
  "temperature": 0.7,
  "autoCommit": false,
  "confirmBeforeExecute": true,
  "theme": "dark",
  "editor": "vscode",
  "hooks": {
    "beforeCommit": "npm run lint"
  },
  "statusLine": {
    "enabled": true,
    "format": "detailed"
  }
}

配置说明

选项	说明	默认值
model	使用的模型	claude-sonnet-4-5
maxTokens	最大 token 数	8000
autoCommit	自动创建 commit	false
confirmBeforeExecute	执行前确认	true
theme	主题	dark

---

🔧 IDE 集成

📝 VS Code

1. 安装 Claude Code 扩展

2. 在 VS Code 中按 Ctrl+Shift+P

3. 选择 "Claude: Start Session"

Vim/Neovim

配置快捷键调用 Claude：

" 在 .vimrc 或 init.vim 中
nnoremap <leader>c :!claude<CR>

Emacs

使用 shell 命令调用：

(defun run-claude ()
  (interactive)
  (async-shell-command "claude"))

---

💎 最佳实践

1. 🎯 明确的指令

❌ 不好的例子：

修复这个

✅ 好的例子：

修复 login.js 文件中的认证错误，当用户输入空密码时应该显示错误提示

2. 📋 分步骤进行大型重构

对于大型更改，先让 Claude 制定计划：

你: 我想重构数据库层，使用 TypeORM 替代原生 SQL。请先分析现有代码并制定计划。

3. 💭 利用上下文

Claude 会记住对话历史：

你: 读取 user.service.ts
Claude: [读取文件]
你: 在这个文件中添加一个删除用户的方法

4. 💾 定期提交

让 Claude 定期创建 git commit：

你: 创建一个 commit 保存这些更改

5. 🔍 使用代码审查

在创建 PR 后：

你: /review-pr 456

6. 🧪 测试驱动

要求 Claude 先写测试：

你: 先为用户认证功能编写测试，然后实现功能

7. 🔒 安全意识

避免将敏感信息放入代码：

你: 创建一个配置文件模板 .env.example，但不要包含实际的 API keys

---

❓ 常见问题

Q: Claude 修改了不应该修改的文件怎么办？

A: 使用 git 恢复：

git checkout -- filename

Q: 如何让 Claude 只读取不修改？

A: 明确说明：

只读取并分析 src/auth 目录中的代码，不要做任何修改

Q: 如何取消正在执行的操作？

A: 按 Ctrl+C

Q: 如何切换模型？

A: 使用命令：

/model opus    # 切换到 Opus
/model sonnet  # 切换到 Sonnet
/model haiku   # 切换到 Haiku

---

💡 实用技巧

1. 📦 批量文件操作

你: 为 src/components 目录下所有 .tsx 文件添加 PropTypes 验证

2. 📖 代码解释

你: 解释 algorithm.js 中的排序算法是如何工作的

3. ⚡ 性能优化

你: 分析 api/users.js 的性能瓶颈并优化

4. 📝 文档生成

你: 为 utils.js 中的所有函数生成 JSDoc 注释

5. 📦 依赖管理

你: 检查 package.json 中的依赖，更新过时的包

---

⌨️ 快捷键

快捷键	功能
Ctrl+C	中断当前操作
Ctrl+D	退出（EOF）
↑  / ↓	浏览历史命令
Tab	自动补全（如果支持）

---

📚 获取帮助

• 在 CLI 中: 输入 /help

• GitHub Issues: https://github.com/anthropics/claude-code/issues

• 官方文档: https://docs.anthropic.com/claude-code

---

🔄 更新日志

检查更新：

npm update -g @anthropic/claude-code

---

📝 写在最后

通过这篇详细的教程，相信你已经掌握了 Claude CLI 的核心使用方法。

把时间花在写代码上，而不是折腾账号上，才是正确的选择。 💪

---

🚀 🔗→点击开始使用←

---

💬 交流与反馈

如有问题欢迎交流讨论。

---

📚 核心要点回顾

Claude CLI 是一个强大的 AI 辅助开发工具，可以显著提高你的开发效率。关键是：

1. ✅ 提供清晰、具体的指令

2. ✅ 利用 git 进行版本控制

3. ✅ 定期审查 Claude 的更改

4. ✅ 善用规划模式处理复杂任务

5. ✅ 配置 hooks 和 MCP 服务器扩展功能

6. ✅ 选择稳定的 API 服务（推荐 weelinking）

开始使用 Claude CLI，让 AI 成为你的编程助手！

---

感谢阅读！祝编程愉快！ 🎉