Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
Claude Code 是 Anthropic 的命令行编程工具。本文档会说明如何在不同操作系统上安装 Claude Code，如何接入 ApiPass，以及如何查看每次请求扣除的积分。
请先确认你已经准备好：
Windows 用户可以选择原生 PowerShell，也可以使用 WSL2。如果你的项目直接放在 Windows 文件系统里，PowerShell 更简单；如果项目已经在 WSL2 里，请把安装和配置都放在 WSL2 中完成。
Anthropic 当前推荐使用原生安装脚本：
1curl -fsSL https://claude.ai/install.sh | bash也可以使用 Homebrew：
1brew install --cask claude-code如果你已有 Node.js/npm 环境，也可以继续使用 npm：
1npm install -g @anthropic-ai/claude-code安装完成后检查版本和环境：
1claude --version
2claude doctor使用 Windows 原生安装脚本：
1irm https://claude.ai/install.ps1 | iex也可以使用 WinGet：
1winget install Anthropic.ClaudeCodeAnthropic 建议在 Windows 原生环境中安装 Git for Windows，这样 Claude Code 可以优先使用 Bash 工具；如果没有安装 Git for Windows，Claude Code 会回退到 PowerShell。
安装完成后检查版本和环境：
1claude --version
2claude doctor打开你的 WSL2 发行版，在 WSL shell 内执行 Linux 安装命令：
1curl -fsSL https://claude.ai/install.sh | bash不要使用 WSL1。如果项目已经在 WSL2 中，请把 Claude Code 的安装、环境变量和运行都保持在 WSL2 里。
原生安装版本会在后台自动更新。Homebrew 和 WinGet 版本会在你执行对应包管理器的升级命令时更新。
Claude Code 会从环境变量读取 API 入口和认证信息。接入 ApiPass 时，把 ANTHROPIC_BASE_URL 指向 ApiPass 网关，并把 ApiPass API Key 写入 ANTHROPIC_AUTH_TOKEN。
1export ANTHROPIC_BASE_URL="https://api.apipass.dev"
2export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"如果要持久保存到 zsh：
1echo 'export ANTHROPIC_BASE_URL="https://api.apipass.dev"' >> ~/.zshrc
2echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
3source ~/.zshrc如果你使用 bash，请把同样内容写入 ~/.bashrc。
只在当前 PowerShell 会话中生效：
1$env:ANTHROPIC_BASE_URL = "https://api.apipass.dev"
2$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"写入当前 Windows 用户环境变量：
1[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apipass.dev", [System.EnvironmentVariableTarget]::User)
2[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)在 WSL shell 内设置同样的变量：
1export ANTHROPIC_BASE_URL="https://api.apipass.dev"
2export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"WSL2 和 Windows 原生 PowerShell 是两个不同环境。文件、环境变量和认证状态不会自动共享，请在实际运行 claude 的同一个终端里完成配置。
在你的项目目录中启动 Claude Code：
1claude启动后即可在交互式会话中提交编程任务、代码审查、排错和重构请求。
Claude Code 请求通过 ApiPass 处理时会扣除积分。实际扣除数量取决于模型、token 用量，以及当前 API Key 或账号匹配到的计费规则。
你可以在这些页面查看费用和用量：
在 API Logs 表格中，Credits 列就是每次请求扣除的积分。点击详情可以看到请求参数和 token 统计。API Usage 页面里的 Claude Code 区块会展示总请求数、总积分、模型分布、token 拆分和趋势图。
如果你的 API Key 需要开启 Claude Code 权限，可以在 API Keys 页面编辑该 Key，打开 Enable Claude Code，并按需要设置 concurrent_limit 并发数量。
claude: command not found安装后请重新打开终端，然后检查：
1claude --version如果 Windows 仍然无法识别 claude，请确认 Claude Code 已写入 PATH，并确认原生安装脚本或 Git for Windows 安装过程已经完成。
确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 设置在实际运行 claude 的同一个终端环境中。
如果你使用 Windows，请确认你是在 PowerShell 还是 WSL2 中运行 Claude Code。除非你确实两个环境都要用，否则不要把配置分散在两个环境里。
如果 Claude Code 返回连接错误或 404，请确认 base URL 为：
1https://api.apipass.dev除非你的部署明确要求额外路径，否则不要把 Claude Code 指向其他子路径。
如果你还需要配置 Codex，可以在左侧文档导航中打开相关教程，或直接进入 Codex CLI 配置教程。