如何在ubuntu20.04系统配置Claude code使用中国大模型

1. 安装claude code

1. 安装nvm

2. 通过nvm 安装node.js

$ nvm--version0.39.3 $npm--version11.12.1 $node--vv22.14.0

3. 安装 claude-code

npminstall-g@anthropic-ai/claude-code

2. 安装litellm

1. 安装python3.10

2. 创建python虚拟环境ccx

3. 安装litellm

#$ mkvirtualenv ccx -p /usr/bin/python3.10(ccx)$ pipinstalllitellm(ccx)$ pipinstall'litellm[proxy]'(ccx)$ pipinstallhttpx[socks]

3. 配置claude code

3.1 启用litellm

在~/.zshrc文件中添加以下内容：

exportZHIPU_API_KEY=<your_api_key>

运行source ~/.zshrc命令，使环境变量生效。

创建litellm_config.yaml（与下文启动命令文件名一致），并添加以下内容。Claude Code 会通过 Anthropic 接口请求诸如claude-sonnet-4-6等官方模型名，因此需要一条model_name: "*"的通配路由，把这些名称全部转到实际使用的国内模型。

model_list:# - model_name: qwen# litellm_params:# model: dashscope/qwen-plus# - model_name: kimi# litellm_params:# model: moonshot/moonshot-v1-8k-model_name:"*"litellm_params:model:zai/glm-5.1api_key:os.environ/ZHIPU_API_KEY-model_name:glmlitellm_params:model:zai/glm-5.1api_key:os.environ/ZHIPU_API_KEYlitellm_settings:drop_params:true

Claude Code 会带上 Anthropic 专有字段（如context_management），转给 GLM 时需丢弃；drop_params: true即由 LiteLLM 自动去掉后端不支持的参数。

运行 LiteLLM 代理：

(ccx)➜ ccx litellm--configlitellm_config.yaml--port4000INFO: Started server process[379725]INFO: Waitingforapplication startup. ██╗ ██╗████████╗███████╗██╗ ██╗ ███╗ ███╗ ██║ ██║╚══██╔══╝██╔════╝██║ ██║ ████╗ ████║ ██║ ██║ ██║ █████╗ ██║ ██║ ██╔████╔██║ ██║ ██║ ██║ ██╔══╝ ██║ ██║ ██║╚██╔╝██║ ███████╗██║ ██║ ███████╗███████╗███████╗██║ ╚═╝ ██║ ╚══════╝╚═╝ ╚═╝ ╚══════╝╚══════╝╚══════╝╚═╝ ╚═╝#------------------------------------------------------------## ## 'This product would be better if...' ## https://github.com/BerriAI/litellm/issues/new ## ##------------------------------------------------------------#Thank youforusing LiteLLM!- Krrish&Ishaan Give Feedback / Get Help: https://github.com/BerriAI/litellm/issues/new LiteLLM: Proxy initialized with Config, Set models: qwen kimi glm INFO: Application startup complete. INFO: Uvicorn running on http://0.0.0.0:4000(Press CTRL+C to quit)

3.2 配置claude code

1. 在~/.zshrc文件中添加以下内容：

exportANTHROPIC_API_KEY=dummyexportANTHROPIC_BASE_URL=http://127.0.0.1:4000

2. 运行source ~/.zshrc命令，使环境变量生效。

3. 运行claude命令，并输入以下内容：

$ claude

• Choose the text style that looks best with your terminal
• ANTHROPIC_API_KEY: sk-ant-…dummy [选择yes]
• Enter
• yes

4. 如果运行claude初始化配置有问题，则执行以下命令重新配置:

$rm-rf~/.claude* $ claude

4. 测试claude code

1. 运行claude命令，并输入以下内容：

$ claude>写一个python函数，判断质数 ❯