Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手,可以直接在终端中帮你写代码、修 Bug、做 Code Review。但国内用户面临两大障碍:网络不通、缺少 API Key

本文将教你如何在国内环境下 5 分钟配通 Claude Code CLI,全程不需要翻墙。

什么是 Claude Code CLI?

Claude Code 是 Anthropic 发布的 Agentic Coding Tool,运行在终端内。你可以把它理解为终端版的 Cursor 或 Copilot——它能:

相比网页版 Claude,Claude Code 的上下文窗口更大(200K tokens),且能直接操作文件系统,特别适合大型项目的开发。详见 GPT-4o vs Claude 文章中的 Claude 在长代码处理上的优势。

国内使用的两大痛点

痛点 1:Claude Code 默认连接 api.anthropic.com,国内网络无法访问。
痛点 2:获取 Anthropic API Key 需要境外信用卡和手机号验证。

幸运的是,Claude Code 支持自定义 API 端点(通过环境变量),这让我们可以通过 API 中转服务绕开这两个问题。

三步配置 Claude Code

第 1 步:安装 Claude Code

Claude Code 通过 npm 全局安装(需要 Node.js 18+):

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

安装完成后验证:

claude --version

第 2 步:获取 API 中转密钥

注册 API 中转服务,购买 Claude 套餐后获取 API 密钥(Token)。这和 ChatGPT API 接入教程 中的流程类似。

第 3 步:配置环境变量

将以下两行加入你的 shell 配置文件(~/.zshrc~/.bashrc):

export ANTHROPIC_API_KEY="sk-your-claude-token-here"
export ANTHROPIC_BASE_URL="https://your-provider.com"

重新加载配置:

source ~/.zshrc

配置完成后,进入任意项目目录,运行 claude 即可启动交互模式。第一次运行会提示你授权文件访问权限。

排查技巧:如果连接失败,检查:① API Key 是否正确(无多余空格);② BASE_URL 不要带 /v1 后缀;③ 套餐是否已激活。

Claude Code 常用命令

claude                        # 启动交互模式
claude "修复这个 bug"           # 单次提问
claude --model claude-sonnet-4 # 指定模型
claude commit                 # 自动生成 commit message
claude --help                 # 查看所有命令

Claude Code vs Cursor/Copilot

特性Claude CodeCursorGitHub Copilot
运行环境终端IDEIDE
文件操作✅ 直接写文件✅ 内联编辑✅ 内联建议
Shell 命令✅ 可执行✅ 终端内❌ 不支持
Git 集成✅ commit/pr✅ 基础✅ 基础
上下文窗口200K tokens视模型视模型
国内可用性通过中转 ✅需翻墙需翻墙

⚡ 配置 Claude Code:获取 API 密钥

Claude 包月 ¥60 起 · 国内直连 · 5 分钟配通

查看 Claude 套餐

常见问题

Q: Claude Code 和普通 Claude 对话有什么区别?

Claude Code 专为编程场景优化,能直接读写文件、执行命令、理解代码仓库结构。普通 Claude 适合通用对话和文档处理。建议两个场景配合使用。

Q: Claude Code 支持哪些模型?

默认使用 Claude Sonnet 4(速度快、性价比高),也可切换为 Claude Opus 4(最强推理)。通过 --model 参数指定。

Q: 使用中转服务会不会影响 Claude Code 的功能?

不会。Claude Code 的功能完全取决于 API 返回,中转服务只是提供网络通道,不影响模型能力和工具调用。

📖 延伸阅读: GPT-4o vs Claude 深度对比 · ChatGPT API 国内接入教程 · 国内使用 GPT-4o 完整指南