Claude Code 使用指南

Claude Code 是 Anthropic 官方的终端编程代理，适合在本地代码库中做阅读、修改、测试和审查。它更像一个长期协作的命令行搭档，而不是单次问答工具。

适合谁

• 主要在终端里工作
• 希望 AI 直接理解当前仓库
• 需要较完整的文件编辑、命令执行和审查流程

官方系统要求

根据 Anthropic 官方文档，Claude Code 的基础要求是：

• macOS 10.15 及以上
• Ubuntu 20.04+ / Debian 10+
• Windows 10+，官方建议通过 WSL 或 Git for Windows 使用
• Node.js 18+
• 至少 4 GB 内存

安装

macOS

方案 A：npm 全局安装

npm install -g @anthropic-ai/claude-code

方案 B：官方原生安装器

curl -fsSL https://claude.ai/install.sh | bash

Linux

方案 A：npm 全局安装

npm install -g @anthropic-ai/claude-code

方案 B：官方原生安装器

curl -fsSL https://claude.ai/install.sh | bash

Windows

官方支持 Windows，但更推荐通过 WSL 2 运行，这样兼容性通常更好。

方案 A：在 WSL 中安装

npm install -g @anthropic-ai/claude-code

方案 B：PowerShell 原生安装器

irm https://claude.ai/install.ps1 | iex

安装后检查

claude --version
claude doctor

claude doctor 可以帮助确认安装方式、版本和常见环境问题。

接入 Flash API

Claude Code 可以通过环境变量或配置文件改走 Flash API。

你需要准备

• 已安装 Claude Code
• 一个可用的 Flash API Key
• 如果你的后台区分令牌组，优先创建 Claude / Anthropic 对应的 Key

Flash API 地址

https://ai.flashapi.top

方式 A：环境变量

macOS / Linux

export ANTHROPIC_AUTH_TOKEN="你的Flash API Key"
export ANTHROPIC_BASE_URL="https://ai.flashapi.top"

如果想永久生效，可以写入 shell 配置文件：

echo 'export ANTHROPIC_AUTH_TOKEN="你的Flash API Key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://ai.flashapi.top"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的Flash API Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.flashapi.top", "User")

Windows CMD

setx ANTHROPIC_AUTH_TOKEN "你的Flash API Key"
setx ANTHROPIC_BASE_URL "https://ai.flashapi.top"

设置完成后，重开终端再运行 claude。

方式 B：配置文件

如果你不想把变量写进 shell，可以直接写 Claude Code 配置目录。

macOS / Linux

mkdir -p ~/.claude

Windows

mkdir %USERPROFILE%\.claude

在目录里创建 settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的Flash API Key",
    "ANTHROPIC_BASE_URL": "https://ai.flashapi.top"
  }
}

首次启动需要跳过官方初始化时怎么办

如果你第一次启动就因为默认走 Anthropic 官方初始化而报错，可以提前在用户目录下的 ~/.claude.json 中加入：

{
  "hasCompletedOnboarding": true
}

如果该文件已经存在，就只补充这个字段，不要把原有内容删掉。

首次使用

进入你的项目目录后执行：

cd /path/to/your/project
claude

首次启动时，Claude Code 会引导你完成登录和授权。官方默认是连接 Anthropic 自己的服务。

日常使用建议

在项目根目录启动

Claude Code 在项目根目录运行时，通常能更好地理解仓库结构。

cd /path/to/project
claude

让任务描述更具体

比起“帮我改一下这里”，下面这种说法通常更稳定：

请先阅读 src/api 和 src/auth 目录，说明当前登录流程。
然后只修改 token 刷新逻辑，不要改动路由结构。
最后告诉我你改了哪些文件、有没有需要我手动验证的地方。

配合仓库说明文件使用

如果项目里有 AGENTS.md、README.md、测试命令说明或目录约定，Claude Code 的表现通常会更稳定。

macOS / Windows / Linux 的差异建议

macOS

• 原生支持较完整。
• 如果你已经用 Homebrew / Node 管理开发环境，安装最省心。

Windows

• 更推荐 WSL 2，尤其是涉及 shell、路径、Git、权限和脚本时。
• 如果你在原生 PowerShell 下使用，路径和命令行为可能与社区示例不同。

Linux

• CLI 体验通常最直接。
• 如果是最小化发行版，遇到搜索或系统库问题时，优先检查 ripgrep 和 Node 版本。

推荐启动方式

完成 Flash API 配置后，进入项目目录启动：

cd /path/to/project
claude

如果你的 Key、地址和环境变量都正确，Claude Code 后续请求就会通过 Flash API 转发。

常见问题

安装时报权限错误

不要直接用 sudo npm install -g。Anthropic 官方明确不建议这样做。更稳妥的做法是修正 Node / npm 全局目录权限，或者使用官方原生安装器。

Windows 下行为不稳定

优先切到 WSL 2 再试。很多终端代理工具在 WSL 下都比原生 CMD / PowerShell 更稳定。

启动后不在项目上下文中

先确认你是不是在仓库根目录里启动的；如果不是，Claude Code 能看到的上下文会少很多。

启动时报 Unable to connect to Anthropic services

大多是下面几种情况：

• 还没有设置 ANTHROPIC_BASE_URL
• 终端没有重启，旧环境变量还在
• 首次启动卡在官方 onboarding，没跳过初始化
• Key 不可用或不匹配当前模型

官方链接

• Anthropic 文档：https://docs.anthropic.com/en/docs/claude-code/getting-started
• Claude Code 安装页：https://docs.anthropic.com/en/docs/claude-code/setup