Claude Code 使用指南

主题

常见问题 ​

Frequently Asked Questions

基础问题 ​

Claude Code 免费吗？ ​

Claude Code 本身是免费安装的，但使用时需要以下之一：

  • Claude Pro 订阅（$20/月）— 有使用限额
  • Claude Max 订阅（$100/$200/月）— 推荐，限额更高或无限
  • Claude Teams/Enterprise — 企业用户
  • API Key — 按 Token 计费，通过 ANTHROPIC_API_KEY 环境变量设置

推荐使用 Claude Max 订阅，获得最佳体验。

支持哪些操作系统？ ​

操作系统支持状态备注
macOS✅ 完全支持推荐平台
Linux✅ 完全支持包括各主流发行版
Windows✅ 支持需要 WSL 或 Git for Windows (Bash)

Windows 用户怎么使用？ ​

两种方式：

  1. WSL（推荐）：安装 WSL2，在 Linux 环境中使用

    bash
    wsl --install
# 进入 WSL 后
npm install -g @anthropic-ai/claude-code

  2. Git for Windows：安装 Git for Windows，在 Git Bash 中使用

    bash
    # 在 Git Bash 终端中
npm install -g @anthropic-ai/claude-code

需要什么版本的 Node.js？ ​

需要 Node.js 18 或更高版本。推荐使用 Node.js 20 LTS。

bash
node --version  # 检查版本

使用问题 ​

如何切换模型？ ​

bash
# 命令行参数
claude --model claude-opus-4-6

# REPL 中切换
> /model

# 在 settings.json 中设置默认模型
{
  "model": "claude-opus-4-6"
}

可用模型：claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5

上下文满了怎么办？ ​

Claude Code 的上下文窗口约 200K tokens。当接近上限时：

  1. 自动压缩 — Claude Code 会自动触发上下文压缩
  2. 手动压缩 — 使用 /compact 命令，可附加保留指令
  3. 清除重来 — 使用 /clear 清除所有上下文
  4. 新会话 — 退出后重新启动

如何减少 Token 消耗？ ​

  1. 完成任务后及时 /clear
  2. 使用 /compact 压缩长对话
  3. 使用精确的提示词，减少来回沟通
  4. 使用 Skills 替代 CLAUDE.md 中的长指令
  5. 简单任务使用 Haiku 模型
  6. 使用 /cost 监控费用

支持中文对话吗？ ​

完全支持。Claude Code 可以用中文进行所有交互，包括：

  • 中文提示词
  • 中文代码注释
  • 中文文档生成
  • 中文 CLAUDE.md

如何查看费用？ ​

bash
# REPL 中查看当前会话费用
> /cost

# 输出示例：
# 当前会话费用: $0.045
# Token 使用: 输入 12,450 / 输出 3,280

安全问题 ​

代码安全吗？会上传到服务器吗？ ​

  • Claude Code 读取的文件内容会发送到 Anthropic 的 API 进行处理
  • Anthropic 不会使用你的代码数据训练模型
  • API 通讯使用 TLS 加密
  • 企业用户可选择 AWS Bedrock 或 Google Vertex 以满足合规要求

如何防止 Claude 执行危险操作？ ​

  1. 使用 Default 模式（默认），每次操作需确认
  2. 配置权限规则，deny 列表中加入危险操作
  3. 使用 Hooks 的 PreToolUse 事件做安全检查
  4. 不要在不受信任的环境中使用 --dangerously-skip-permissions

MCP 问题 ​

MCP 服务器连不上怎么办？ ​

排查步骤：

  1. 检查 MCP 服务器是否正确安装

    bash
    claude mcp list  # 查看配置的服务器

  2. 检查环境变量是否配置

    bash
    # .mcp.json 中的 env 字段是否正确

  3. 手动测试 MCP 服务器

    bash
    claude mcp serve  # 调试模式

  4. 检查网络连接（对于远程 MCP 服务器）

如何在团队间共享 MCP 配置？ ​

使用项目根目录的 .mcp.json 文件：

json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

将此文件提交到 Git 仓库，团队成员只需设置对应的环境变量。

对比问题 ​

Claude Code vs Cursor？ ​

特性Claude CodeCursor
界面终端 CLI + IDE 扩展独立 IDE
灵活性极高（MCP/Skills/Hooks）中等
扩展性MCP 协议 + Skills 系统内置功能
自动化支持无头模式、CI/CD不支持
学习曲线较陡（需熟悉终端）平缓
价格Pro $20 / Max $100Pro $20

Claude Code vs GitHub Copilot？ ​

特性Claude CodeGitHub Copilot
工作方式Agent 模式（主动执行）补全模式（被动建议）
文件操作可读写任意文件仅在编辑器中补全
终端操作可执行命令不可以
Git 操作可直接操作 Git不可以
上下文整个项目当前文件周围

故障排查 ​

Claude Code 启动报错 ​

bash
# 检查 Node.js 版本
node --version  # 需要 18+

# 清除缓存重装
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

# 检查网络（可能需要代理）
export HTTPS_PROXY=http://your-proxy:port

认证失败 ​

bash
# 重新认证
claude auth login

# 或使用 API Key
export ANTHROPIC_API_KEY=sk-ant-your-key

如何反馈 Bug？ ​

其他问题 ​

如何离线使用？ ​

Claude Code 不支持离线使用，需要网络连接才能与 Claude API 通信。

团队如何共享配置？ ​

将以下文件提交到 Git 仓库：

项目根/
├── CLAUDE.md                # 项目级指令
├── .mcp.json                # MCP 配置
└── .claude/
    ├── settings.json        # 项目设置
    └── skills/              # 团队技能

个人配置使用 .claude/settings.local.json（加入 .gitignore）。

最大支持多大的文件？ ​

Claude Code 可以读取任意大小的文件，但：

  • 大文件会消耗大量上下文 Token
  • 建议一次只读取需要的文件部分
  • 对于超大文件，使用 Grep 搜索定位后再读取相关段落