codex 国内使用可以选择中转站,这里推荐:https://codex.packycode.com/
购买套餐获取 key,以后,使用下面脚本来一键安装,需要将 “sk-tC8cF…jyi” 替换成真正的 key:
1#!/bin/bash
2# Codex Setup Script
3
4# 1. Create .codex directory
5mkdir -p ~/.codex
6
7# 2. Create config.toml
8cat > ~/.codex/config.toml << 'EOF'
9model_provider = "packycode"
10model = "gpt-5" #可更改为model = "gpt-5-codex"
11model_reasoning_effort = "high"
12disable_response_storage = true
13
14[model_providers.packycode]
15name = "packycode"
16base_url = "https://codex-api.packycode.com/v1"
17wire_api = "responses"
18requires_openai_auth = true
19EOF
20
21# 3. Create auth.json
22cat > ~/.codex/auth.json << 'EOF'
23{
24 "OPENAI_API_KEY": "sk-tC8cF...jyi"
25}
26EOF
27
28# 4. Start Codex
29echo "Setup complete! You can now run 'codex' to start."
30codex
安装一些常用的 mcp,命令如下:
1# 创建全局 npm 目录
2mkdir -p ~/.npm-global
3
4# 配置 npm 使用该目录
5npm config set prefix '~/.npm-global'
6
7# 将该目录添加到 PATH(添加到 ~/.bashrc 或 ~/.zshrc)
8echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
9source ~/.bashrc
10
11# 现在可以无 sudo 安装全局包
12npm install -g @modelcontextprotocol/server-sequential-thinking @modelcontextprotocol/server-memory @mook_wy/mook-task-manager @tosin2013/mcp-shrimp-task-manager
然后在 ~/.codex/config.toml 里面配置 mcp,其中 exa 需要在官网 https://docs.exa.ai/reference/exa-mcp 注册以后获取 key,替换 YOUR_KEY_VALUE:
1[mcp_servers.sequential-thinking]
2command = "npx"
3args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
4startup_timeout_sec = 60000
5
6[mcp_servers.exa]
7command = "npx"
8args = ["-y", "exa-mcp-server", "tools=web_search_exa,get_code_context_exa,crawling_exa,company_research_exa,linkedin_search_exa,deep_researcher_start,deep_researcher_check"]
9env = { "EXA_API_KEY" = "YOUR_KEY_VALUE" }
10startup_timeout_sec = 60000
11
12[mcp_servers.shrimp-task-manager]
13command = "npx"
14args = ["-y", "@mook_wy/mook-task-manager@latest"]
15env = {"DATA_DIR" = ".shrimp", "TEMPLATES_USE" = "zh", "ENABLE_GUI" = "false"}
16startup_timeout_sec = 60000
17
18[mcp_servers.memory]
19command = "npx"
20args = ["-y", "@modelcontextprotocol/server-memory"]
21startup_timeout_sec = 60000
然后设置一个好用的 ~/.codex/AGENTS.md
1【全局 AGENTS 约束(简要)】
2
3本指南适用于仓库全部目录,除非子目录另有 AGENTS.md 覆盖。
4所有沟通全部使用中文、所有的代码注释、文档全部使用英文(并且只写关键部分的注释),新文件使用 UTF-8(无 BOM)。
5禁用一切 CI/CD 自动化;构建、测试、发布必须人工操作。
6编码前必须先使用 Sequential-Thinking 进行分析,然后使用 shrimp-task-manager 规划工作流程,并保持最小变更边界。
7默认采取破坏性改动并拒绝向后兼容,主动清理过时代码、接口、文档;如无迁移需求需说明“无迁移,直接替换”。
8回复格式必须:
9在开头提供【前置说明】(简要说明:本次任务、假设、是否调用工具等)。
10若有工具/MCP/外部调用,在结尾提供【工具调用简报】(列出用过哪些工具、用途和结论)。
11缩进根据当前文件编码风格决定使用 1 个 tab 还是用 4 个空格,默认使用 4 个空格。