AI 部署指南

Appearance

Claude Code 接入指南（代理配置） ​

一句话 ​

Claude Code 是 Anthropic 推出的终端 AI 编程助手，能直接在命令行里帮你写代码、改文件、跑命令。这篇教程教你绕过国内网络限制，把它跑起来。

🤖 AI Agent 快速入口

本页 Markdown 可通过 Accept: text/markdown 请求头获取。

curl -H "Accept: text/markdown" https://doc.k4b.cn/agents/claude-code-setup.md

快速部署（AI 版） ​

前置条件 ​

  • [ ] Node.js 18+ 已安装
  • [ ] 已注册 Anthropic 账号并有 API Key
  • [ ] 已配置代理（SOCKS5 或 HTTP 代理）

安装步骤 ​

bash
# 1. 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 2. 配置 API Key（二选一）
# 方式 A：直接设置
export ANTHROPIC_API_KEY=sk-ant-你的key

# 方式 B：使用 claude 配置文件
echo 'ANTHROPIC_API_KEY=sk-ant-你的key' >> ~/.claude/.env

# 3. 配置代理（必须，国内直连会超时）
# 注意：HTTP_PROXY 和 HTTPS_PROXY 都用 http:// 协议，
# 因为 Clash/V2Ray 等工具通过 HTTP CONNECT 隧道转发 HTTPS 流量
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 4. 启动 Claude Code
claude

验证 ​

bash
claude -p "Hello, 写一个 Python hello world"
# 看到代码输出 → 配置成功

详细教程（人类版） ​

Claude Code 是什么？ ​

Claude Code 是 Anthropic 出品的终端 AI 工具，直接跑在你的命令行里。与 Cursor 这类 IDE 插件不同，Claude Code 跟你的终端深度绑定——它能读文件、改代码、跑命令、看输出，像一个跟你结对编程的工程师坐在你旁边。

国内为什么需要它？

  • Cursor 绑定了 VS Code 生态
  • Claude Code 是纯终端工具，跟任何编辑器都能配合
  • 对服务器运维、Docker 部署等场景特别友好

第一步：注册 Claude 账号 ​

这一步是国内开发者的最大门槛。需要满足两个条件：

  1. 境外手机号 — 推荐用接码平台（如 SMS-Activate）
  2. 境外支付方式 — 推荐用 Depay/OneKey 等虚拟卡

💡 关于境外支付：如果你觉得注册太麻烦，考虑用中转 API 方案，详见 API Key 管理。

注册好之后，在 console.anthropic.com 创建 API Key。

第二步：安装 Claude Code ​

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

如果不顺利，先配好 npm 镜像再装：

bash
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

第三步：配置 API Key ​

bash
# 方式一：环境变量（临时生效，退出终端消失）
export ANTHROPIC_API_KEY=sk-ant-你的key

# 方式二：配置文件（永久生效）
mkdir -p ~/.claude
echo 'ANTHROPIC_API_KEY=sk-ant-你的key' >> ~/.claude/.env

第四步：配置代理 ​

这是国内使用 Claude Code 最关键的一步。不配代理的话，API 请求会直接超时。

bash
# 如果你用 Clash/V2Ray（默认端口 7890）
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 如果你想持久化，加到 shell 配置里
echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
source ~/.bashrc

怎么确认代理配通了？

bash
# 测试能否连上 Anthropic API
curl -x http://127.0.0.1:7890 https://api.anthropic.com/v1/ping
# 返回 {"ok": true} → 通了

第五步：启动验证 ​

bash
claude

首次启动会进入交互式会话模式。输入 Hello，Claude Code 应当正常响应。

想测试非交互模式：

bash
claude -p "写一个 Python 脚本，打印 1 到 10"

如果正常输出了代码，说明配置成功。

常见问题 ​

Q：Claude Code 启动报错 "Network Error" A：检查代理是否开启，以及终端是否真的读到了 HTTP_PROXY 环境变量。用 echo $HTTP_PROXY 确认。

Q：有没有不配代理的方案？ A：如果你有海外服务器，可以在那里搭一个中转 API 反代。详见我们的 API Key 管理指南。

Q：费用贵吗？ A：Claude Code 按 API 用量计费。日常开发每月大约 $10-50。不如订阅制的 Cursor 划算，但胜在灵活。

相关教程 ​