Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手,可以直接在终端中帮你写代码、修 Bug、做 Code Review。但国内用户面临两大障碍:网络不通、缺少 API Key。
本文将教你如何在国内环境下 5 分钟配通 Claude Code CLI,全程不需要翻墙。
什么是 Claude Code CLI?
Claude Code 是 Anthropic 发布的 Agentic Coding Tool,运行在终端内。你可以把它理解为终端版的 Cursor 或 Copilot——它能:
- 理解整个代码仓库的结构
- 自动生成和修改文件
- 运行 shell 命令(经你确认后)
- 创建 commit、管理 Git 工作流
- 修复编译错误和 lint 警告
相比网页版 Claude,Claude Code 的上下文窗口更大(200K tokens),且能直接操作文件系统,特别适合大型项目的开发。详见 GPT-4o vs Claude 文章中的 Claude 在长代码处理上的优势。
国内使用的两大痛点
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 即可启动交互模式。第一次运行会提示你授权文件访问权限。
/v1 后缀;③ 套餐是否已激活。
Claude Code 常用命令
claude # 启动交互模式
claude "修复这个 bug" # 单次提问
claude --model claude-sonnet-4 # 指定模型
claude commit # 自动生成 commit message
claude --help # 查看所有命令
Claude Code vs Cursor/Copilot
| 特性 | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|
| 运行环境 | 终端 | IDE | IDE |
| 文件操作 | ✅ 直接写文件 | ✅ 内联编辑 | ✅ 内联建议 |
| Shell 命令 | ✅ 可执行 | ✅ 终端内 | ❌ 不支持 |
| Git 集成 | ✅ commit/pr | ✅ 基础 | ✅ 基础 |
| 上下文窗口 | 200K tokens | 视模型 | 视模型 |
| 国内可用性 | 通过中转 ✅ | 需翻墙 | 需翻墙 |
常见问题
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 完整指南