Claude Code 配置指南

🧠

智能编程

Claude 深度理解代码上下文，提供精准的编程建议和代码生成。

自然对话

用自然语言描述需求，Claude 帮你实现，支持多轮对话迭代。

📁

项目感知

自动分析项目结构和依赖，给出符合项目风格的代码建议。

无需翻墙

国内直连，无需 VPN 或代理工具。配置环境变量后即可直接使用，告别网络烦恼。

🚀 一键配置

一条命令自动完成所有配置，无需手动修改文件

                             curl -sL '/api/setup/claude?key=YOUR_API_KEY' | bash
                         
                             irm '/api/setup/claude-win?key=YOUR_API_KEY' | iex

脚本将自动完成：
环境检查 → 服务端连接测试 → 清理旧配置 → 写入环境变量 → API 连接验证

快速开始

选择你的操作系统，复制命令并在终端执行

步骤 1: 安装 Claude Code
                            curl -fsSL https://claude.ai/install.sh | bash
                        
步骤 2: 配置环境变量
                            export ANTHROPIC_BASE_URL=""
                        
                            export ANTHROPIC_API_KEY="你的密钥"
                        
步骤 3: 启动 Claude Code
                            cd 你的项目目录 && claude
                        
步骤 1: 安装 Claude Code (PowerShell)
                            irm https://claude.ai/install.ps1 | iex
                        
步骤 2: 配置环境变量
                            set ANTHROPIC_BASE_URL=
                        
                            set ANTHROPIC_API_KEY=你的密钥
                        
步骤 3: 启动 Claude Code
                            cd 你的项目目录 && claude
                        
步骤 1: 安装 Claude Code
                            brew install --cask claude-code
                        
步骤 2: 配置环境变量
                            export ANTHROPIC_BASE_URL=""
                        
                            export ANTHROPIC_API_KEY="你的密钥"
                        
步骤 3: 启动 Claude Code
                            cd 你的项目目录 && claude

📋

需要 Node.js 18+ (claude 命令依赖)

⚙️

环境变量建议写入 ~/.bashrc 或 ~/.zshrc 以永久生效

首次使用建议在小项目中测试，熟悉 Claude 的工作方式

使用 /help 命令查看 Claude Code 支持的所有命令

本平台无需翻墙，国内网络可直接访问。注意：ANTHROPIC_BASE_URL 不需要加 /v1 后缀

重要提醒：配置冲突排查
如果设置了环境变量仍然出现 403 错误或连接失败，请检查以下文件是否存在旧配置：
• ~/.claude/.credentials.json — Claude 自身的认证文件，可能覆盖你的环境变量
• ~/.claude/settings.json — Claude 的设置文件
建议使用以下命令一键写入永久配置：

# 一键写入环境变量（永久生效）
# macOS (zsh):
echo 'export ANTHROPIC_BASE_URL=""' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的密钥"' >> ~/.zshrc
source ~/.zshrc

# Linux (bash):
echo 'export ANTHROPIC_BASE_URL=""' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="你的密钥"' >> ~/.bashrc
source ~/.bashrc

常见问题

遇到问题？这里可能有答案

安装后提示 "command not found"？

请确认安装路径已加入系统 PATH。macOS/Linux 用户可执行 source ~/.bashrc 或重启终端。

配置环境变量后仍然连接失败？

请检查 ANTHROPIC_BASE_URL 是否正确（不带 /v1 后缀）。设置后需重启终端或新开窗口才能生效。

提示 "403 Country not supported" 怎么办？

这个错误通常是因为直接连接了 Anthropic 官方服务器。请确认 ANTHROPIC_BASE_URL 指向本平台地址，并确认环境变量已生效（重启终端或新开窗口）。如果仍不行，请检查 ~/.claude/.credentials.json 是否存在旧认证配置。

环境变量怎么永久保存？

将 export ANTHROPIC_BASE_URL="平台地址" 和 export ANTHROPIC_API_KEY="你的密钥" 写入 ~/.zshrc（macOS）或 ~/.bashrc（Linux）。可以参考上方「使用小贴士」中的一键写入命令。

Claude Code 支持哪些编程语言？

Claude Code 支持所有主流编程语言，包括 Python、JavaScript/TypeScript、Go、Rust、Java、C++ 等。

如何更新 Claude Code？

使用与安装相同的命令即可更新到最新版本。Homebrew 用户可执行 brew upgrade claude-code。

和直接使用 Anthropic 官方服务有什么区别？

本平台作为 API 代理，无需翻墙即可在国内直接使用 Claude Code。功能完全相同，同时提供更优惠的价格和稳定的连接质量。

设置了环境变量还是报 403 错误？

最常见的原因是 Claude 本身的认证文件 ~/.claude/.credentials.json 中存在旧的认证信息，导致请求绕过本平台。解决方法：检查并清理该文件，然后确认 ANTHROPIC_BASE_URL 环境变量已正确设置。可使用上方「使用小贴士」中的一键修复命令。