Windows WSL 环境下配置 Claude Code 非官方账号完整教程
这里的 2233.ai为第三方API账号举例,可以解决国内很多小伙伴无法完成充值的问题。
重要提示 ⚠️
当 Claude Code 在 Windows 环境下通过 WSL 运行时,必须在 WSL 环境中使用 Linux 命令设置环境变量,在 Windows PowerShell 中设置是无效的!
第一步:安装 Claude Code
1. 进入 WSL 环境
wsl
2. 安装 Node.js(如果未安装)
css
# 检查版本
node --version
npm --version
3. 安装 Claude Code
bash
sudo npm install -g @anthropic-ai/claude-code
4. 验证安装
css
claude --version
第二步:配置 API 密钥和服务地址(关键步骤)
方法一:永久配置(推荐)
bash
# 1. 添加环境变量到 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
# 2. 重新加载配置
source ~/.bashrc
方法二:临时配置(仅当前会话)
ini
export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
方法三:使用配置文件
bash
# 创建配置目录
mkdir -p ~/.config/claude-code
# 创建配置文件
nano ~/.config/claude-code/config.json
添加内容:
json
{
"apiKey": "你的API密钥",
"baseURL": "https://aicoding.2233.ai"
}
第三步:验证配置是否生效
1. 启动 Claude Code
bash
cd /path/to/your/project
claude
2. 使用 /status 命令检查配置 ✅
在 Claude Code 中输入:
shell
> /status
正确配置的输出示例:
yaml
────────────────────────────────────────────────────
Settings: Status Config Usage
Version: 2.0.14
Session ID: a64a5f70-9a7c-4d7d-b93c-bc705082876a
cwd: /mnt/d/PycharmProjects/主力资金
Auth token: ANTHROPIC_AUTH_TOKEN ✅
Anthropic base URL: https://aicoding.2233.ai ✅
Model: opus (claude-opus-4-1-20250805)
────────────────────────────────────────────────────
关键检查点:
- ✅
Auth token显示为ANTHROPIC_AUTH_TOKEN - ✅
Anthropic base URL显示为https://aicoding.2233.ai
常见错误示例 ❌
错误 1:在 PowerShell 中设置环境变量
ruby
# ❌ 这在 WSL 中无效!
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aicoding.2233.ai", [System.EnvironmentVariableTarget]::User)
错误 2:使用 PowerShell 语法
ini
# ❌ 这是 PowerShell 语法,bash 不支持
$env:ANTHROPIC_BASE_URL = "https://aicoding.2233.ai"
完整操作流程
bash
# 1. 从 Windows PowerShell 进入 WSL
wsl
# 2. 配置环境变量
echo 'export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc
# 3. 进入项目目录
cd /mnt/d/PycharmProjects/你的项目
# 4. 启动 Claude Code
claude
# 5. 验证配置
> /status
其他有用命令
bash
# 查看当前环境变量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
# 编辑配置文件
nano ~/.bashrc
# 重新加载配置
source ~/.bashrc
# 查看 Claude Code 帮助
claude --help
注意事项
- API 密钥安全:不要将 API 密钥提交到 git 仓库
- 路径访问 :WSL 可以访问 Windows 文件系统(
/mnt/c/,/mnt/d/等) - 权限警告 :
/status中的权限警告通常不影响正常使用 - 配置验证 :每次配置后都应该用
/status命令验证